OctoPrint auf dem Raspberry Pi – 3D-Drucker per Web-Interface steuern

OctoPrint auf dem Raspberry Pi installieren – der komplette Setup-Guide

Ihr wollt euren 3D-Drucker mit dem Raspberry Pi steuern – bequem vom Browser aus, Druckfortschritte per Webcam überwachen und nie wieder am Drucker stehen bleiben, um einen G-Code-File zu laden? Dann ist OctoPrint genau das Richtige – und ein Raspberry Pi ist die perfekte Hardware dafür.

In diesem Tutorial zeige ich euch, wie ihr OctoPrint auf dem Raspberry Pi mit dem offiziellen OctoPi-Image einrichtet, eine Webcam einbindet und die wichtigsten Plugins installiert.

Was ist OctoPrint?

OctoPrint ist eine kostenlose, quelloffene Web-Oberfläche für 3D-Drucker. Ihr steuert euren Drucker damit komplett vom Browser aus – egal ob vom PC, Smartphone oder Tablet. Kein USB-Stick mehr, kein Rumgefummel an der SD-Karte des Druckers.

Die wichtigsten Funktionen auf einen Blick:

  • G-Code-Dateien hochladen und Drucke starten/pausieren/abbrechen
  • Echtzeit-Temperaturkurven für Hotend und Heizbett
  • Webcam-Livestream direkt im Browser
  • Timelapse-Videos von euren Drucken automatisch erstellen
  • Über 400 Plugins für Benachrichtigungen, Visualisierungen und mehr
  • API für die Einbindung in Home Assistant, Node-RED und andere Systeme

Hardware-Voraussetzungen

Für OctoPrint braucht ihr nicht viel:

Komponente Empfehlung Hinweis
Raspberry Pi Pi 4 (2 GB) oder Pi 5 Pi Zero 2 W geht, aber langsam. Pi Zero 1 nicht empfohlen.
MicroSD-Karte Mind. 16 GB, Class 10 32 GB empfohlen wenn ihr viele G-Code-Dateien speichert
USB-Kabel USB-A zu USB-B oder USB-C Je nach Druckeranschluss – muss Datenkabel sein, nicht nur Ladekabel
Webcam (optional) USB-Webcam oder Pi Camera Module 3 Für Livestream und Timelapse
Netzteil Offizielles Pi-Netzteil Wichtig: ausreichend Strom, da USB-Kabel zum Drucker zusätzlich zieht

Als Webcam funktionieren die meisten USB-Webcams problemlos. Bewährt hat sich die Logitech C270* – günstig, zuverlässig und sofort erkannt. Wer die Pi Camera nutzen möchte, ist mit dem Raspberry Pi Camera Module 3* am besten bedient. Welches Kameramodul sich für welchen Zweck eignet, zeigt der Raspberry Pi Kamera-Vergleich.

Mit * markierte Links sind Affiliate-Links, also Werbung. Kauft ihr darüber ein, erhalte ich eine Provision, der Preis bleibt für euch gleich. Als Amazon-Partner verdiene ich an qualifizierten Verkäufen. Mehr dazu

OctoPi installieren: das OctoPrint-Image für den Raspberry Pi

Der einfachste Weg ist das OctoPi-Image – ein auf Raspberry Pi OS basierendes System-Image, das OctoPrint, den Webcam-Streamer und alle nötigen Dienste bereits vorinstalliert enthält.

Schritt 1: Raspberry Pi Imager starten

Öffnet den Raspberry Pi Imager auf eurem PC (kostenloser Download auf raspberrypi.com). Er führt euch als Assistent durch die Schritte: Wählt zuerst unter Modell euren Raspberry Pi und geht dann weiter zu Betriebssystem.

Schritt 2: OctoPi-Image auswählen

Navigiert zu: Other specific-purpose OS → 3D printing → OctoPi

Dort stehen zwei Einträge zur Wahl: OctoPi (stable) mit dem klassischen Webcam-Streamer und OctoPi (new experimental camera stack) mit dem neuen Streamer. Mit einer USB-Webcam sind beide in Ordnung, mit einem Raspberry-Pi-Kameramodul (v2, v3, HQ) nehmt ihr zwingend den zweiten Eintrag, auch wenn er im Imager noch als experimentell gilt – Details im Webcam-Abschnitt weiter unten. Das Image enthält die aktuelle stabile OctoPrint-Version; seit OctoPi 1.1.0 (Mai 2025) läuft es auch auf dem Raspberry Pi 5.

Schritt 3: Einstellungen konfigurieren

Wählt unter Speicher eure MicroSD-Karte. Danach öffnet der Imager die Anpassung. Tragt dort ein:

  • Hostname: z.B. octopi (erreichbar dann als octopi.local)
  • WLAN-Zugangsdaten: SSID und Passwort eures Heimnetzwerks
  • Benutzername & Passwort: Den Namen wählt ihr frei, dazu setzt ihr ein sicheres Passwort
  • SSH aktivieren: Empfohlen für spätere Wartung

Schritt 4: Image auf SD-Karte schreiben

Klickt zum Schluss auf „Schreiben“. Nach ca. 5–10 Minuten ist der Vorgang abgeschlossen.

Schritt 5: Pi starten und OctoPrint aufrufen

SD-Karte in den Pi einlegen, Stromversorgung anschließen und ca. 2–3 Minuten warten bis der erste Boot abgeschlossen ist. Dann im Browser öffnen:

http://octopi.local

Falls octopi.local nicht funktioniert, nutzt die IP-Adresse des Pi – zu finden im Router oder per nmap -sn 192.168.x.0/24.

OctoPrint einrichten (Setup-Wizard)

Beim ersten Aufruf startet OctoPrint automatisch den Setup-Assistenten:

  1. Admin-Konto erstellen: Benutzername und Passwort für die OctoPrint-Weboberfläche festlegen (unabhängig vom Linux-Systempasswort)
  2. Online-Überprüfung: Erlaubt OctoPrint zu prüfen ob Updates verfügbar sind
  3. Drucker-Profil: Druckbettgröße und Druckkopf-Anzahl eintragen
  4. Fertig: Das Dashboard erscheint

Drucker verbinden

Verbindet euren 3D-Drucker per USB-Kabel mit dem Raspberry Pi. In OctoPrint oben links:

  1. Bei Serial Port entweder AUTO wählen oder den Anschluss manuell (meist /dev/ttyUSB0 oder /dev/ttyACM0)
  2. Die Baudrate eures Druckers einstellen – bei den meisten Prusa, Ender & Co. ist es 115200
  3. Auf „Verbinden“ klicken

Im Terminal-Tab könnt ihr prüfen ob die Verbindung steht – ihr seht dann Temperaturmeldungen vom Drucker.

Typische Baudrate nach Drucker-Modell:

Drucker Baudrate
Prusa MK3S+, MK4, XL 115200
Creality Ender 3, CR-10 115200
Anycubic Kobra, Mega 115200
Bambu Lab (nur via Plugin) —
Alte Drucker (Marlin <2.0) 250000

Hinweis für Bambu Lab-Nutzer: Bambu-Drucker kommunizieren über MQTT statt USB. Dafür gibt es das Bambu Printer Plugin, das die WLAN-Verbindung nutzt.

Hinweis für Klipper-Drucker: Läuft auf eurem Drucker bereits Klipper (etwa beim Elegoo Neptune 4), braucht ihr kein OctoPrint – die Weboberfläche heißt dort Mainsail oder Fluidd und hängt an Moonraker. Wie ihr so einen Drucker mit Kamera ausstattet, zeigt die Anleitung Neptune 4 Kamera einrichten, die Anbindung an Home Assistant steht in 3D-Drucker in Home Assistant einbinden.

Webcam einrichten

OctoPi bringt den Webcam-Streamer direkt mit. Welcher das ist, hängt vom Image ab, das ihr im Imager gewählt habt:

  • OctoPi (stable) – der klassische mjpg-streamer. Eine USB-Webcam wird automatisch erkannt, das Bild erscheint direkt im Dashboard. Die Raspberry-Pi-Kameramodule (v2, v3, HQ) funktionieren mit diesem Image nicht – der alte camera="raspi"-Weg in der octopi.txt wird nicht mehr unterstützt.
  • OctoPi (new experimental camera stack) – der neue Streamer camera-streamer, der USB-Webcams und die Pi-Kameramodule bedient. Wer ein Camera Module 3 nutzen will, flasht dieses Image; ein nachträglicher Umbau ist aufwendiger als neu zu flashen.

Pi Camera Module 3 nutzen (New Camera Stack)

Kameramodul per Flexkabel an den CSI-Anschluss des Pi, Image mit New Camera Stack flashen – mehr ist im Normalfall nicht nötig: Die Kamera wird beim Start erkannt, der Autofokus des Camera Module 3 ist standardmäßig aktiv. Auflösung und Bildrate stellt ihr per SSH in der Konfigurationsdatei ein (Grundlagen zum Modul: Raspberry Pi Kamera einrichten):

sudo nano /etc/camera-streamer.conf.d/libcamera.conf

Die ausgelieferten Werte sind ein guter Kompromiss für den Pi – Stream in 720p, Snapshots und damit Timelapses in 1080p:

WIDTH=1920
HEIGHT=1080
VIDEO_HEIGHT=720
SNAPSHOT_HEIGHT=1080
FRAMERATE=15

Nach Änderungen den Dienst neu starten:

sudo systemctl restart camera-streamer-libcamera

Stream-Qualität anpassen

In Settings → Webcam & Timelapse könnt ihr die Stream-URL anpassen und die Snapshot-URL für Timelapses einstellen. Standard-URLs bei OctoPi (bei beiden Stacks gleich, alternativ über den eingebauten Proxy als http://octopi.local/webcam/?action=stream):

Stream URL:    http://octopi.local:8080/?action=stream
Snapshot URL:  http://octopi.local:8080/?action=snapshot

Die wichtigsten OctoPrint-Plugins

Plugins installiert ihr über Settings → Plugin Manager → Get More. Diese fünf sind ein guter Start:

Plugin Funktion
Octolapse Professionelle Timelapse-Videos: Druckkopf fährt für jeden Frame zur Seite → sauberes Wachstum sichtbar
OctoEverywhere Sicherer Fernzugriff über das Internet ohne Port-Forwarding – kostenlose Basis-Version verfügbar
PrintTimeGenius Deutlich genauere Restzeit-Schätzung als der eingebaute Algorithmus
Bed Visualizer Druckbett-Leveling als 3D-Karte visualisieren – ideal zum Prüfen ob ABL korrekt arbeitet
Cancel Objects Einzelne Objekte aus einem Multi-Objekt-Druck abbrechen ohne den gesamten Druck zu stoppen

Für die KI-Fehlererkennung gibt es das Plugin Obico (früher The Spaghetti Detective), das misslungene Drucke erkennt und pausiert. Wer das lieber komplett lokal und ohne Cloud baut, findet in der Serie KI-Druckwächter mit dem Arduino UNO Q einen eigenen Ansatz.

Fernzugriff: OctoEverywhere einrichten

Mit OctoEverywhere habt ihr von überall Zugriff auf euren Drucker – ohne euren Router zu öffnen. Nach der Plugin-Installation:

  1. OctoPrint neu starten
  2. In OctoPrint unter Settings → OctoEverywhere auf Finish Your 20 Second Setup Now! klicken, das öffnet die Webseite von OctoEverywhere
  3. Dort einen kostenlosen Account anlegen oder anmelden, der Drucker wird dabei automatisch hinzugefügt
  4. Fertig – euren Drucker erreicht ihr jetzt über octoeverywhere.com

Der Webcam-Stream funktioniert dabei ebenfalls über die verschlüsselte Verbindung. Wer keinen Cloud-Dienst dazwischen haben will, erreicht OctoPrint auch über ein eigenes VPN – etwa mit einem WireGuard-Server auf dem Raspberry Pi.

Häufige Probleme und Lösungen

Drucker wird nicht erkannt (/dev/ttyUSB0 fehlt):
Prüft ob das USB-Kabel wirklich ein Datenkabel ist. Viele Drucker-Zubehörpakete liegen reine Ladekabel bei. Alternativ: lsusb per SSH prüfen ob der Drucker überhaupt auftaucht.

OctoPi.local nicht erreichbar:
Unter Windows ist Bonjour/mDNS manchmal nicht installiert. Entweder iTunes installieren (bringt Bonjour mit) oder direkt die IP-Adresse aus dem Router-Interface nutzen.

Webcam zeigt kein Bild:
Per SSH prüfen, ob der Streamer läuft – beim stable-Image sudo systemctl status webcamd, beim New Camera Stack sudo systemctl status 'camera-streamer-*'. Beim stable-Image taucht in der /boot/firmware/octopi.txt nur noch die USB-Webcam auf; wenn ihr dort ein Pi-Kameramodul betreiben wollt, ist das falsche Image geflasht.

Druckabbrüche durch USB-Verbindungsverlust:
Meist steckt Rückspeisung dahinter: Der Pi speist über das USB-Kabel 5 V in das Drucker-Mainboard (erkennbar daran, dass das Druckerdisplay leuchtet, obwohl der Drucker aus ist) oder umgekehrt der Drucker in den Pi. Lösung: den 5-V-Kontakt im USB-Stecker mit einem Streifen Tape abkleben oder einen USB-Power-Blocker zwischenstecken – der lässt nur die Datenleitungen durch. Ein USB-Hub mit eigener Stromversorgung hilft ebenfalls.

Häufige Fragen zu OctoPrint auf dem Raspberry Pi

Welcher Raspberry Pi eignet sich am besten für OctoPrint?

Für OctoPrint reicht bereits ein Raspberry Pi 3B+ (1 GB RAM), empfohlen wird jedoch der Raspberry Pi 4 (2–4 GB RAM) für flüssige Webcam-Streams und mehrere Plugins gleichzeitig. Der Pi 5 ist deutlich überdimensioniert – sein Leistungsvorsprung zeigt sich bei OctoPrint kaum. Das offizielle OctoPi-Image läuft auf allen Modellen ab Pi 2, seit OctoPi 1.1.0 (Mai 2025) auch auf dem Pi 5.

Was ist der Unterschied zwischen OctoPrint und OctoPi?

OctoPrint ist die Web-Software für die 3D-Drucker-Steuerung. OctoPi ist ein vorkonfiguriertes Raspberry Pi OS Image, das OctoPrint bereits vorinstalliert und konfiguriert enthält. Mit OctoPi spart ihr die manuelle Installation – einfach Image flashen, WLAN-Daten eintragen und loslegen. Die OctoPrint-Software selbst läuft auch auf anderen Linux-Systemen.

Kann OctoPrint auch von unterwegs erreichbar gemacht werden?

Ja, aber nicht einfach per Port-Forwarding – das wäre ein Sicherheitsrisiko. Empfohlen: Tailscale auf dem Pi installieren (curl -fsSL https://tailscale.com/install.sh | sh, danach sudo tailscale up), dann ist der Pi sicher von überall erreichbar. Alternativ das OctoEverywhere-Plugin, das eine verschlüsselte Cloud-Verbindung herstellt, ohne Ports öffnen zu müssen.

Welche Webcam funktioniert mit OctoPrint auf dem Raspberry Pi?

Die meisten USB-Webcams mit UVC-Treiber (USB Video Class) werden automatisch erkannt – z. B. die Logitech C270, Logitech C920 oder Microsoft LifeCam. Das Raspberry Pi Camera Module 3 funktioniert ebenfalls gut, braucht aber das OctoPi-Image mit New Camera Stack – im klassischen stable-Image laufen die Pi-Kameramodule nicht. Wichtig: Full HD (1080p) für Snapshots und 720p für den Stream reichen völlig aus, höhere Auflösungen belasten den Pi unnötig.

Was ist mit OctoPrint 2.0 – muss ich updaten?

OctoPrint 2.0 ist seit Frühjahr 2026 im Release-Candidate-Stadium und noch nicht final. Das OctoPi-Image aus dem Imager enthält die aktuelle stabile Version; sobald 2.0 final ist, bietet der Software-Updater in OctoPrint das Update an. Vor einem Versionssprung lohnt ein Backup über Settings → Backup & Restore, damit ihr bei Plugin-Problemen zurück könnt.

Brauche ich OctoPrint, wenn mein Drucker WLAN hat?

Moderne Drucker mit Cloud-Anbindung (etwa Bambu Lab) bringen vieles selbst mit. OctoPrint lohnt sich vor allem für die riesige Basis an USB-Druckern ohne smarte Funktionen — und für alle, die volle Kontrolle ohne Hersteller-Cloud wollen.

Was kostet OctoPrint?

Nichts — OctoPrint ist Open Source und kostenlos. Das Projekt lebt von freiwilliger Unterstützung der Community, etwa über GitHub Sponsors oder Patreon.

Fazit

OctoPrint verwandelt euren 3D-Drucker in eine vollständig vernetzbare Maschine. Die Installation über das OctoPi-Image ist in 15 Minuten erledigt und der Komfortgewinn ist enorm: G-Code-Files per Browser hochladen, Temperatur im Blick behalten, Timelapse-Videos automatisch erstellen und von unterwegs prüfen ob der Druck noch läuft.

Besonders in Kombination mit einem Raspberry Pi 4 oder 5 läuft OctoPrint stabil und schnell – ein würdiger Begleiter für jeden Maker mit 3D-Drucker.

Ähnliche Beiträge