OctoPrint Lasergravur funktioniert, unter ein paar Bedingungen. OctoPrint ist eine Host-Software für 3D-Drucker: Es streamt den G-Code Zeile für Zeile über den USB-Port an die Maschine, und ob das Werkzeug ein Hotend oder ein Laser ist, spielt dafür keine Rolle. Eine Marlin-Maschine mit eingeschalteter Laserfunktion läuft so, wie sie ist; ein GRBL-Laser braucht ein Plugin; eine Duet-Karte erledigt dieselbe Aufgabe ohne OctoPrint. Sie bereiten den G-Code in einer Lasersoftware vor, schicken ihn an den Server und starten ihn, und manche Lasersoftware, darunter Bernie, erledigt all das für Sie.
Im Folgenden: was OctoPrint unterstützt, welche Grenzen Sie kennen sollten, bevor Sie darüber ein Foto gravieren, wie Sie OctoPrint oder eine Duet-Karte für einen Laser einrichten, eine vollständige Anleitung, um mit Bernie den Rahmen abzufahren und zu gravieren, und dasselbe über die Kommandozeile.
Kann OctoPrint einen Lasergravierer steuern?
OctoPrint ist freie Open-Source-Software (AGPL-3.0), entwickelt und gepflegt von Gina Häußge und durch Spenden finanziert. Die aktuelle stabile Version ist 1.11.8, erschienen im Juni 2026; Version 2.0 ist in der Testphase. Die meisten betreiben es auf einem Raspberry Pi mit OctoPi, einem fertigen Image für die SD-Karte: Das Projekt empfiehlt einen Pi 3B, 3B+, 4B oder Zero 2.
OctoPrint versteht sich als Oberfläche für 3D-Drucker und bringt keine eingebaute Unterstützung für Laser oder GRBL mit. Ob Ihr Laser dahinter funktioniert, entscheidet die Firmware der Maschine:
| Firmware | Hinter OctoPrint | Was Sie brauchen |
|---|---|---|
| Marlin mit Laser | Ja: Es ist eine Drucker-Firmware | LASER_FEATURE aktiviert; Laserleistung über M3, M4 und M5 |
| GRBL (die meisten Diodenlaser) | Mit einem Plugin | Das Plugin Better Grbl Support, das den Handshake und den von OctoPrint gesendeten G-Code anpasst |
| RepRapFirmware (Duet) | Nicht nötig | Die Duet-Karte führt Aufträge von ihrer eigenen SD-Karte aus, über Duet Web Control oder ihre HTTP-API; Lasermodus mit M452 eingestellt |
Die Laser-Dokumentation von Marlin beschreibt einen Inline-Modus (M3 I), bei dem die Leistung mit jeder Bewegung mitgeschickt wird, statt den Kopf anzuhalten, um sie zu ändern. Bei einer Duet-Karte legt M452 den Laserausgang, die PWM-Frequenz und den S-Wert für volle Leistung fest.
Grenzen, die Sie vor der OctoPrint Lasergravur kennen sollten
- Streaming-Geschwindigkeit. Standardmäßig sendet OctoPrint eine Zeile und wartet auf das „ok“ der Maschine, bevor es die nächste schickt. Die Dokumentation von GRBL selbst nennt dieses einfache Senden und Antworten die langsamste Art zu streamen und empfiehlt für schnelle Maschinen wie Laser das Zeichenzählen (Character Counting). Vektorschnitte und Konturen sind kein Problem; ein Foto aus Tausenden winziger Bewegungen kann ruckeln, also senken Sie die Geschwindigkeit oder die Auflösung oder nehmen Sie für Rastergravuren lieber eine direkte USB-Verbindung.
- Eine Duet-Karte umgeht das Problem. Sie führt die ganze Datei von ihrer SD-Karte aus, während des Auftrags wird also nichts gestreamt.
- Sicherheit. Die Dokumentation von OctoPrint warnt davor, eine Maschine mit Motoren und Heizelementen aus dem Internet erreichbar zu machen, selbst mit Zugangskontrolle: Nutzen Sie ein VPN. Ein Laser verdient dieselbe Sorgfalt.
- OctoPrint 2.0. Die nächste Hauptversion ändert, wie Drucker verbunden werden, und das Projekt hat die Plugin-Autoren gebeten, ihre Plugins zu prüfen. Wenn Sie auf Better Grbl Support angewiesen sind, prüfen Sie vor dem Upgrade, ob es Ihre OctoPrint-Version unterstützt.
OctoPrint oder eine Duet-Karte für einen Laser einrichten
OctoPrint
- Schreiben Sie OctoPi mit dem Raspberry Pi Imager auf eine microSD-Karte (Other specific-purpose OS › 3D printing), starten Sie den Pi und schließen Sie den Einrichtungsassistenten in Ihrem Browser unter
http://octopi.localab. - Schließen Sie den Laser per USB an den Pi an. Für einen GRBL-Laser installieren Sie Better Grbl Support über den Plugin Manager: Es stellt den Handshake ein, schaltet die Prüfsummen ab und akzeptiert
.nc-Dateien. - Erstellen Sie einen Schlüssel für die Lasersoftware. Die Dokumentation von OctoPrint empfiehlt Anwendungsschlüssel (Settings › Application Keys); der ältere globale Schlüssel unter Settings › API gilt als veraltet.
- Nur wenn Sie OctoPrint aus einer Webseite steuern wollen: Setzen Sie unter Settings › API das Häkchen bei Allow Cross Origin Resource Sharing (CORS) und starten Sie OctoPrint dann neu.
Duet (RepRapFirmware)
Richten Sie den Lasermodus mit M452 in der config.g ein, mit dem Ausgangspin und der Leistungsskala Ihrer Karte. Seit RepRapFirmware 3.7 ist HTTP nicht mehr standardmäßig aktiv: Ergänzen Sie M586 P0 S1. Ein mit M551 gesetztes Passwort schützt den Zugang, wobei die Duet-Dokumentation darauf hinweist, dass es unverschlüsselt übertragen wird. Für eine Webseite erlaubt M586 C"*" Cross-Origin-Anfragen. Bernie spricht mit einer Duet-Karte im Standalone-Modus, also mit einer Karte, die selbst mit dem Netzwerk verbunden ist.
So gravieren Sie mit Bernie über OctoPrint
Bernie, die kostenlose Lasersoftware, kann den Auftrag direkt an OctoPrint oder an eine Duet-Karte schicken: Es bereitet den G-Code für Ihre Maschine vor, lädt ihn als Datei hoch, startet ihn nach einer Sicherheitsfrage und verfolgt seinen Fortschritt. Hier ein Namensschild aus Sperrholz von 80 × 30 mm auf einem Sculpfun S9, einem GRBL-Diodenlaser hinter OctoPrint.
- Installieren Sie Bernie. Nehmen Sie die Mac-App, die Windows-App oder die Desktop-App für Linux von der Download-Seite. Bernie Studio funktioniert auch im Browser, aber nur, wenn die Seite über http ausgeliefert wird, von Bernie Link oder auf Ihrem Computer: Die Online-Version in https kann keinen Server in http erreichen.
- Wählen Sie Ihre Maschine. Suchen Sie sie im Katalog aus, hier den Sculpfun S9, damit der G-Code zu ihrer Firmware, ihrem Arbeitsbereich und ihren Geschwindigkeiten passt. Die Seite kompatible Maschinen listet die 125 Modelle auf.
- Wählen Sie die Verbindungsart „Server“. Stellen Sie im Bereich „Laser“ Anbindung auf Server und dann auf OctoPrint. Geben Sie die Adresse (
http://octopi.local) und den API-Schlüssel ein und klicken Sie dann auf Verbinden. Auf Mac und iPad wird der Schlüssel im Schlüsselbund gespeichert. - Platzieren Sie das Design. Der Server meldet nicht, wo der Kopf steht, also starten Sie in absoluten Koordinaten oder ab Ihrem Benutzerursprung.
- Fahren Sie den Rahmen ab. Klicken Sie auf Umrahmen: Der Kopf fährt den Auftrag bei ausgeschaltetem Laser ab. Verschieben Sie das Sperrholz, bis die Kontur dort liegt, wo Sie sie haben wollen.
- Gravieren Sie. Klicken Sie auf Starten und beantworten Sie die Sicherheitsfrage: Bernie lädt den Auftrag als Datei hoch, OctoPrint startet ihn, und der Bereich zeigt den Fortschritt. Pause, Fortsetzen und Stoppen bleiben verfügbar.
- Behalten Sie die Wartung im Blick. Diese Aufträge zählen im Stundenzähler wie alle anderen; siehe unseren Wartungsplan für Lasergravierer.
Für eine Duet-Karte wählen Sie Duet statt OctoPrint und geben das mit M551 gesetzte Passwort ein oder lassen das Feld leer, wenn es keins gibt. Der Abschnitt Verbindung des Handbuchs behandelt alle Verbindungsarten, und Verbindung und Steuerung fasst sie zusammen.
Gravieren Sie kostenlos über OctoPrint
Wiederholen Sie diese Schritte mit Ihrem eigenen Laser: Bernie ist kostenlos, ohne Konto und ohne Abo, auf Mac, Windows, Linux und mit Bernie Studio in Ihrem Browser.
Über die Kommandozeile
Der Befehl bernie macht dasselbe ohne Fenster, aus einem Terminal oder einem Skript. Er wird mit Bernie Link geliefert: auf einem Raspberry Pi oder einem Linux-PC nach der Installation mit einer Zeile und als bernie.exe im Windows-Archiv. Für das Namensschild oben ergibt das:
$ bernie verifier name-tag.bernie --appareil sculpfun-s9Device : Sculpfun S9✓ Ready to engrave.$ bernie estimer name-tag.bernie --appareil sculpfun-s9Estimated duration : 1 min 39 sLaser on : 39 sLength engraved : 3914 mm
Um über OctoPrint zu gravieren, geben Sie den Server und seinen Schlüssel an: bernie graver name-tag.bernie --appareil sculpfun-s9 --octoprint http://octopi.local --cle YOUR_KEY --oui. Für eine Duet-Karte nehmen Sie --duet http://duet.local --mot-de-passe PASSWORD. Ohne --oui wird nichts gesendet: Der Befehl antwortet, dass beim Gravieren der Laser eingeschaltet wird, und bittet Sie, mit geschlossenem Deckel und laufender Absaugung zu bestätigen. Danach verfolgt er den Auftrag bis zum Ende, und Ctrl-C bricht ihn ab.
Für Kleinserien setzt --serie 42 eine Seriennummer in einen variablen Text ein, und --csv names.csv holt die Werte aus einem Tabellenexport; --json liefert Ergebnisse, die ein Skript lesen kann, mit dem Exit-Code 0, wenn der Auftrag erledigt ist, und 1, wenn er abgelehnt wird. Der Abschnitt Befehl bernie des Handbuchs listet alle Optionen auf, und die Seite Dateien und Automatisierung zeigt die anderen Wege, Bernie aus einem anderen Programm zu steuern.
Sicher bleiben, wenn der Laser außer Sichtweite ist
Ein Druckserver verleitet dazu, einen Auftrag aus einem anderen Raum zu starten. Lassen Sie es: Ein Laser darf nie unbeaufsichtigt laufen. Starten Sie Aufträge nur, wenn Sie neben der Maschine stehen, mit einer Schutzbrille für ihre Wellenlänge, laufender Absaugung und einem Feuerlöscher griffbereit. Bernie stellt vor jedem Auftrag eine Sicherheitsfrage, aber es kann die Maschine nicht sehen; Sie schon. Gravieren Sie nie PVC oder Vinyl, die Chlor freisetzen.
Vor einem Auftrag über OctoPrint oder eine Duet-Karte
- Sie stehen an der Maschine, Schutzbrille auf, Absaugung läuft.
- Die Maschine hat ihre Referenzfahrt gemacht, und das Design startet in absoluten Koordinaten oder ab Ihrem Benutzerursprung.
- Der Rahmen des Auftrags wurde bei ausgeschaltetem Laser abgefahren.
- OctoPrint ist nur in Ihrem lokalen Netzwerk oder über ein VPN erreichbar.
Häufige Fragen
Unterstützt OctoPrint Lasergravierer?
Nicht offiziell: OctoPrint ist für 3D-Drucker gebaut. Es streamt aber jeden G-Code, also funktioniert eine Marlin-Maschine mit Laserfunktion, und ein GRBL-Laser funktioniert mit dem Plugin Better Grbl Support. Bereiten Sie den G-Code in einer Lasersoftware vor oder lassen Sie eine Software wie Bernie ihn für Sie hochladen und starten.
Kann OctoPrint einen GRBL-Laser steuern?
Ja, mit dem Plugin Better Grbl Support, das den Handshake anpasst, die Prüfsummen abschaltet und .nc-Dateien akzeptiert. Ohne das Plugin ist der Standard-Handshake von OctoPrint ein Druckerbefehl, den GRBL nicht versteht.
Wie bekomme ich einen API-Schlüssel für OctoPrint?
Erstellen Sie einen Anwendungsschlüssel unter Settings › Application Keys oder lassen Sie die Software einen anfordern. Der ältere globale Schlüssel unter Settings › API funktioniert noch, gilt aber als veraltet. Schicken Sie den Schlüssel mit jeder Anfrage mit; in Bernie tragen Sie ihn in das Feld „API-Schlüssel“ der Verbindungsart „Server“ ein.
Eignet sich OctoPrint, um ein Foto zu lasern?
Es kann ruckeln. OctoPrint sendet eine Zeile nach der anderen und wartet jeweils auf eine Antwort, und ein Foto besteht aus Tausenden winziger Bewegungen. Senken Sie die Geschwindigkeit oder die Auflösung oder nehmen Sie eine direkte USB-Verbindung oder eine Duet-Karte, die die Datei von ihrer SD-Karte ausführt. Unser Ratgeber Foto lasern hilft Ihnen bei der Wahl der Einstellungen.
Kann ich eine Duet-Karte für die Lasergravur nutzen?
Ja. RepRapFirmware hat einen Lasermodus, der mit M452 eingestellt wird, und eine Duet-Karte führt den Auftrag von ihrer eigenen SD-Karte aus. Bernie schickt den Auftrag an eine Duet-Karte im Standalone-Modus, mit Rahmenfahrt, Pause, Fortsetzen und Stopp; seit RepRapFirmware 3.7 schalten Sie HTTP mit M586 P0 S1 ein.
OctoPrint oder eine Duet-Karte können einen Laser gut steuern, solange Sie ihre Grenzen kennen. Bernie ergänzt die Laserseite: Materialeinstellungen, eine Vorabprüfung und eine Sicherheitsfrage vor jedem Auftrag. Laden Sie Bernie herunter, wählen Sie die Verbindungsart „Server“ und fahren Sie den Rahmen Ihres ersten Auftrags ab.