Files
homelab-docs/infrastructure/3D-PRINTING-QUICK-START.md

154 lines
3.7 KiB
Markdown

# 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)