Skip to main content

Quick Start

Start with one printer and a small, observed print before expanding your fleet.

Step 1: Install​

Follow Installation for the Docker Compose configuration, or Windows Installation for Windows. Keep the mounted data volume and generated keys for future upgrades.

Step 2: Log in​

Open http://your-server-ip:8000 and create your admin account in the setup wizard.

Step 3: Add a printer​

Go to Printers > Add Printer. Enter your printer's IP address (and access code or API key, depending on the protocol). O.D.I.N. connects and starts pulling live telemetry within seconds.

Step 4: Prepare and upload a print file​

Slice a small model for the actual printer, nozzle, plate and loaded material in your slicer. For Bambu printers, export a sliced .gcode.3mf. Upload it through Models > Upload. A raw .stl or unsliced .3mf can be stored in the model library but is not ready to dispatch. Education student submissions use their class or club review flow instead of bypassing teacher approval.

Step 5: Start a print​

From the model detail page, click Print. Select the target printer, confirm filament compatibility, and send the job. O.D.I.N. transfers the file and starts the print.

Step 6: Monitor​

Watch your print from the Dashboard. You'll see real-time progress, temperatures, and status for every printer in your farm.

tip

If your printer has a camera configured, O.D.I.N. streams it directly in the dashboard via WebRTC. Camera media still needs the appropriate network access; see Camera Streams.

Before expanding, confirm the physical print completes and ODIN records its completion. If a start request times out, inspect the printer before retrying. Use Guided diagnostics to check the server, printer and protected file transfer.

What to explore next​

Now that your first print is running, here's what else O.D.I.N. can do:

  • Camera streaming -- Add camera feeds to any printer for live video in the dashboard. Supports WebRTC for low-latency and HLS for compatibility. See Configuration > Printers.

  • Vigil AI detection -- O.D.I.N. watches your camera feeds for print failures (spaghetti, detachment, first layer issues) and can auto-pause the printer. See Configuration > AI Detection.

  • Job scheduling -- Queue multiple jobs with color-match scoring, blackout hours, and automatic load balancing across your farm. See Features > Scheduler.

  • Filament & spool tracking -- Log every spool in your inventory with weight tracking, QR label printing, and filament slot assignments. Material usage is tracked per-print automatically.

  • Alerts & notifications -- Get push notifications, emails, or webhooks (Discord, Slack, ntfy, Telegram) when prints finish, fail, or need attention. See Configuration > SMTP & Alerts.

  • Multi-user access -- Add operators and viewers with role-based permissions (Pro tier and above). See Configuration > Users & RBAC.