Skip to main content

Quick Start

From zero to your first print job in 10 minutes.

Step 1: Install​

Run the one-liner on your server:

curl -fsSL https://get.runsodin.com/install.sh | bash

Or see Installation for manual steps and Windows Installation for Windows.

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: Upload a model​

Go to Models > Upload. Drag and drop a .3mf, .gcode, or .stl file. O.D.I.N. parses .3mf files automatically to extract thumbnails, print settings, and filament requirements.

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. No port forwarding or third-party tools needed.

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.