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

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

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

ls -la /mnt/3DPrinting/3DPrinting/

You should see: profiles/, models/, gcode/, projects/

2. Install Orca Slicer

# Install from the downloaded AppImage
sudo install-orca-slicer.sh

3. Launch Orca Slicer

/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:

sync-orca-profiles.sh pull

Share your updated profiles:

sync-orca-profiles.sh push

Check sync status:

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?

# Check if mounted
mount | grep 3DPrinting

# If not mounted
sudo mount-3dprinting.sh

Can't find profiles in Orca Slicer?

# Pull profiles from shared storage
sync-orca-profiles.sh pull

# Restart Orca Slicer

OMV server not accessible?

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

   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