Initial infrastructure documentation - comprehensive homelab reference

2026-02-23 03:42:22 +00:00
commit 0682c79580
169 changed files with 63913 additions and 0 deletions
--- a/infrastructure/3D-PRINTING-QUICK-START.md
+++ b/infrastructure/3D-PRINTING-QUICK-START.md
@@ -0,0 +1,153 @@
+# 3D Printing Setup - Quick Start Guide
+
+Quick reference for setting up Orca Slicer with shared profiles on your homelab.
+
+## First Time Setup (Run these commands)
+
+### 1. Mount the 3DPrinting Share
+
+```bash
+# Mount the OMV share
+sudo mount-3dprinting.sh
+
+# OR set up automatic mounting on boot
+sudo setup-3dprinting-automount.sh
+sudo mount /mnt/3DPrinting
+```
+
+Verify it worked:
+```bash
+ls -la /mnt/3DPrinting/3DPrinting/
+```
+
+You should see: `profiles/`, `models/`, `gcode/`, `projects/`
+
+### 2. Install Orca Slicer
+
+```bash
+# Install from the downloaded AppImage
+sudo install-orca-slicer.sh
+```
+
+### 3. Launch Orca Slicer
+
+```bash
+/opt/OrcaSlicer/orca-slicer.AppImage
+```
+
+Or search for "Orca Slicer" in your application menu.
+
+## Daily Usage
+
+### Slicing a Model
+
+1. Open Orca Slicer
+2. File → Import → Select STL from `/mnt/3DPrinting/3DPrinting/models/`
+3. Select profiles:
+   - Printer: AD5M
+   - Filament: PLA/PETG/etc
+   - Print: Quality level
+4. Slice
+5. Export gcode to `/mnt/3DPrinting/3DPrinting/gcode/queue/`
+6. Transfer to printer and print!
+
+### Syncing Profiles
+
+**Get latest shared profiles:**
+```bash
+sync-orca-profiles.sh pull
+```
+
+**Share your updated profiles:**
+```bash
+sync-orca-profiles.sh push
+```
+
+**Check sync status:**
+```bash
+sync-orca-profiles.sh status
+```
+
+## File Locations
+
+### On OMV (10.0.10.5)
+```
+/srv/dev-disk-by-uuid-1c893fab-9943-43df-8e24-3c9190869955/data/3DPrinting/
+├── profiles/      # Shared Orca Slicer profiles
+├── models/        # STL files
+├── gcode/         # Sliced gcode files
+└── projects/      # Work in progress
+```
+
+### On This Computer
+```
+/mnt/3DPrinting/3DPrinting/  # Mounted share (same as above)
+~/.config/OrcaSlicer/user/   # Local Orca Slicer profiles
+```
+
+## Troubleshooting
+
+### Share not mounted?
+```bash
+# Check if mounted
+mount | grep 3DPrinting
+
+# If not mounted
+sudo mount-3dprinting.sh
+```
+
+### Can't find profiles in Orca Slicer?
+```bash
+# Pull profiles from shared storage
+sync-orca-profiles.sh pull
+
+# Restart Orca Slicer
+```
+
+### OMV server not accessible?
+```bash
+# Test connection
+ping 10.0.10.5
+
+# Check if SMB is running on OMV
+ssh 10.0.10.5 "systemctl status smbd"
+```
+
+## Helper Scripts
+
+All scripts are in `~/.local/bin/`:
+
+| Script | Purpose |
+|--------|---------|
+| `mount-3dprinting.sh` | Mount the 3DPrinting share (requires sudo) |
+| `setup-3dprinting-automount.sh` | Configure automatic mounting on boot |
+| `install-orca-slicer.sh` | Install Orca Slicer from AppImage |
+| `sync-orca-profiles.sh pull` | Download shared profiles |
+| `sync-orca-profiles.sh push` | Upload your profiles to share |
+| `sync-orca-profiles.sh status` | Check sync configuration |
+
+## Next Steps
+
+1. ✅ Mount share: `sudo mount-3dprinting.sh`
+2. ✅ Install Orca Slicer: `sudo install-orca-slicer.sh`
+3. 🔲 Launch Orca Slicer and configure AD5M printer profile
+4. 🔲 Test slice a model
+5. 🔲 Push your AD5M profiles: `sync-orca-profiles.sh push`
+6. 🔲 Install Orca Slicer on other family computers
+7. 🔲 On those computers: mount share, install Orca Slicer, pull profiles
+
+## Family Members: Getting Started
+
+If you're a family member setting up Orca Slicer on your computer:
+
+1. **Mount the network share** (ask Fred for help with this part)
+2. **Install Orca Slicer** - Download from https://github.com/SoftFever/OrcaSlicer/releases/latest
+3. **Get the shared profiles**:
+   ```bash
+   sync-orca-profiles.sh pull
+   ```
+4. **Start slicing!** All the AD5M profiles are ready to use
+
+## Documentation
+
+For complete setup details, see: [3D-PRINTING-SETUP.md](3D-PRINTING-SETUP.md)