Für NAS und Raspberry Pi
Agent installieren, Schritt für Schritt
Wähle dein System, kopiere jede Zeile mit einem Klick und füge sie ein. Docker-Kenntnisse brauchst du nicht. Das dauert etwa 10 Minuten.
Ein Gerät, das immer läuft
Ein Mini-PC wie ein Intel NUC, ein NAS (Synology, QNAP, Unraid), ein Raspberry Pi 4 oder 5 mit 64-Bit-System oder ein Linux-PC. Ein Windows-PC oder Mac geht auch, muss dann aber anbleiben.
Im selben Netz wie deine Drucker
Per Kabel oder WLAN am selben Router.
Etwa 10 Minuten
Jeder Befehl hat einen Kopierknopf. Du musst nichts von Hand abtippen.
Deine Einstellungen
Such dir ein Passwort für die Weboberfläche des Agenten aus. Wir setzen es in jeden Befehl unten ein, du musst nur noch kopieren und einfügen. Es bleibt in diesem Browser-Tab und wird nirgendwohin geschickt.
Mindestens 6 Zeichen: Buchstaben, Zahlen, - _ . (keine Leerzeichen, keine Umlaute), damit die Befehle überall funktionieren. Lass 8090 stehen, außer ein anderes Programm nutzt den Port schon.
Bitte nur Buchstaben ohne Umlaute, Zahlen und - _ . verwenden, mindestens 6 Zeichen. Bis dahin steht in den Befehlen „DeinPasswort“.
Wähle dein System
Nicht sicher? Ein Mini-PC (etwa ein NUC) oder ein Raspberry Pi mit Ubuntu, Debian oder Raspberry Pi OS ist „Linux“. Wenn du deine Container schon mit Portainer verwaltest, nimm Portainer.
Linux: Mini-PC, NUC, Raspberry Pi, Heimserver
Ein Terminal auf dem Gerät öffnen
Du sitzt am Gerät: Öffne die App Terminal. Von einem anderen Rechner aus: Öffne PowerShell (Windows) oder Terminal (Mac) und verbinde dich per SSH. Ersetze
userdurch deinen Benutzernamen auf dem Gerät und die Zahlen durch seine IP-Adresse (steht in der Geräteliste deines Routers):Beim ersten Verbinden tippst du
yes. Beim Eintippen des Passworts erscheint nichts auf dem Bildschirm. Das ist normal, einfach Enter drücken.Prüfen, ob Docker installiert ist
Füge das ein und drücke Enter:
docker --versionDu siehst etwas wie
Docker version 27.3.1? Dann weiter mit Schritt 3. Du siehstcommand not found? Dann installiere Docker mit dieser Zeile, das dauert ein paar Minuten:curl -fsSL https://get.docker.com | sudo shAuf einem Raspberry Pi zusätzlich
uname -meingeben. Da mussaarch64stehen. Steht dortarmv7l, läuft auf dem Pi ein 32-Bit-System: Installiere zuerst Raspberry Pi OS (64-bit).Den Agenten starten
Füge diese Zeile ein. Dein Passwort von oben steht schon drin. Fragt
sudonach einem Passwort, ist das Passwort deines Benutzers auf dem Gerät gemeint:sudo docker run -d --name allmyprinters-agent --restart unless-stopped --network host -e AMP_PASSWORD=DeinPasswort -e AMP_PORT=8090 -e AMP_LANG=de -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestBeim ersten Start wird der Agent heruntergeladen, das kann ein, zwei Minuten dauern. Am Ende steht eine lange Zeile aus Buchstaben und Zahlen. Dann hat es geklappt.
Prüfen, ob er läuft, und die Adresse finden
Füge das ein:
sudo docker ps --filter name=allmyprinters-agentUnter STATUS sollte
Upstehen, nach etwa einer Minute auch(healthy). Jetzt die Adresse des Geräts abfragen:hostname -IDie erste Zahl, zum Beispiel
192.168.1.50, ist die Adresse. Weiter unten bei „Agent öffnen“.
Später aktualisieren
Diese Zeile ausführen. Sie lädt die neueste Version und startet den Agenten mit denselben Einstellungen neu. Deine Daten bleiben erhalten.
sudo docker pull ghcr.io/nolimitek/allmyprinters-agent:latest && sudo docker rm -f allmyprinters-agent && sudo docker run -d --name allmyprinters-agent --restart unless-stopped --network host -e AMP_PASSWORD=DeinPasswort -e AMP_PORT=8090 -e AMP_LANG=de -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestAgent entfernen
Stoppt und entfernt den Agenten. Deine Daten bleiben, du kannst ihn jederzeit wieder starten:
sudo docker rm -f allmyprinters-agentUm auch alle seine Daten zu löschen (Drucker, Spulen, Verlauf, Bibliothek). Das lässt sich nicht rückgängig machen:
sudo docker volume rm allmyprinters-agentSynology-NAS (DSM 7.2 oder neuer)
Container Manager installieren
Öffne in DSM das Paket-Zentrum, suche nach Container Manager und installiere ihn. Ist dein DSM älter als 7.2, aktualisiere es zuerst: Vor 7.2 hieß das Paket Docker und konnte keine Projekte anlegen.
Einen Ordner anlegen
Öffne die File Station. Lege im freigegebenen Ordner docker (den hat Container Manager angelegt) einen neuen Ordner
allmyprinters-agentan.Das Projekt anlegen
Öffne Container Manager → Projekt → Erstellen und trage ein:
- Projektname:
allmyprinters-agent - Pfad: den Ordner docker → allmyprinters-agent auswählen
- Quelle: docker-compose.yml erstellen
Füge das hier ins Textfeld ein. Dein Passwort steht schon drin:
services: allmyprinters-agent: image: ghcr.io/nolimitek/allmyprinters-agent:latest container_name: allmyprinters-agent restart: unless-stopped network_mode: host environment: AMP_PASSWORD: "DeinPasswort" AMP_PORT: "8090" AMP_LANG: "de" volumes: - allmyprinters-agent:/data volumes: allmyprinters-agent: name: allmyprinters-agentKlicke auf Weiter. Das Webportal (Web Station) bleibt aus, noch einmal Weiter und dann Fertig. Container Manager lädt den Agenten herunter und startet ihn, das kann ein, zwei Minuten dauern.
- Projektname:
Prüfen, ob er läuft
Unter Container sollte
allmyprinters-agentals laufend angezeigt werden. Die Adresse ist die, mit der du DSM öffnest, ohne:5000, zum Beispiel192.168.1.50. Weiter unten bei „Agent öffnen“.
Später aktualisieren
Container Manager sucht etwa einmal am Tag nach neuen Versionen. Zeigt Image beim Agenten an, dass ein Update verfügbar ist, wähle es aus und klicke auf Aktualisieren. Container Manager startet den Agenten mit der neuen Version neu, deine Daten bleiben.
Agent entfernen
Projekt → allmyprinters-agent → Aktion → Stoppen, dann Löschen. Die Daten des Agenten bleiben auf dem NAS. Um sie auch zu löschen, per SSH ausführen (nicht rückgängig zu machen):
sudo docker volume rm allmyprinters-agentUnraid
Prüfen, ob Docker an ist
Settings → Docker: „Enable Docker“ muss auf Yes stehen. Das ist von Haus aus so.
Das Terminal öffnen
Klicke oben rechts in der Unraid-Oberfläche auf das Terminal-Symbol >_.
Den Agenten starten
Füge diese Zeile ein und drücke Enter. Dein Passwort steht schon drin:
docker run -d --name allmyprinters-agent --restart always --network host -e AMP_PASSWORD=DeinPasswort -e AMP_PORT=8090 -e AMP_LANG=de -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestBeim ersten Start wird der Agent heruntergeladen. Am Ende steht eine lange Zeile aus Buchstaben und Zahlen. Dann hat es geklappt.
Prüfen, ob er läuft
Im Reiter Docker steht
allmyprinters-agentjetzt als gestartet. Unraid zeigt ihn als Container ohne Vorlage an, das ist in Ordnung. Die Adresse ist die deines Unraid-Servers, zum Beispiel192.168.1.50. Weiter unten bei „Agent öffnen“.
Später aktualisieren
Der Update-Knopf von Unraid funktioniert bei so gestarteten Containern nicht. Öffne stattdessen das Terminal und führe diese Zeile aus. Deine Daten bleiben:
docker pull ghcr.io/nolimitek/allmyprinters-agent:latest && docker rm -f allmyprinters-agent && docker run -d --name allmyprinters-agent --restart always --network host -e AMP_PASSWORD=DeinPasswort -e AMP_PORT=8090 -e AMP_LANG=de -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestAgent entfernen
Stoppt und entfernt den Agenten. Deine Daten bleiben:
docker rm -f allmyprinters-agentUm auch alle seine Daten zu löschen. Das lässt sich nicht rückgängig machen:
docker volume rm allmyprinters-agentPortainer
Einen Stack anlegen
Melde dich bei Portainer an, wähle deine Umgebung (meist local) und klicke auf Stacks → Add stack.
Den Agenten einfügen
Name:
allmyprinters-agent. Build method: Web editor. Füge das hier in den Editor ein. Dein Passwort steht schon drin:services: allmyprinters-agent: image: ghcr.io/nolimitek/allmyprinters-agent:latest container_name: allmyprinters-agent restart: unless-stopped network_mode: host environment: AMP_PASSWORD: "DeinPasswort" AMP_PORT: "8090" AMP_LANG: "de" volumes: - allmyprinters-agent:/data volumes: allmyprinters-agent: name: allmyprinters-agentStarten
Scrolle nach unten und klicke auf Deploy the stack. Portainer lädt den Agenten herunter und startet ihn, das kann eine Minute dauern.
Prüfen, ob er läuft
Unter Containers sollte
allmyprinters-agentals running und nach etwa einer Minute als healthy erscheinen. Die Adresse ist die IP des Geräts, auf dem Portainer läuft, zum Beispiel192.168.1.50. Weiter unten bei „Agent öffnen“.
Später aktualisieren
Stacks → allmyprinters-agent → Editor → Update the stack. Im Dialog Re-pull image and redeploy einschalten und bestätigen. Deine Daten bleiben.
Agent entfernen
Stacks → allmyprinters-agent anhaken → Remove. Die Daten des Agenten bleiben im Volume allmyprinters-agent. Um sie auch zu löschen, entferne dieses Volume unter Volumes (nicht rückgängig zu machen).
Windows-PC oder Mac mit Docker Desktop
Docker Desktop kann dem Agenten keinen direkten Zugang zu deinem Netzwerk geben. Der Agent läuft, aber seine Suche findet keine Drucker von Bambu Lab und Elegoo: Die trägst du mit ihrer IP-Adresse ein. Der Rechner muss anbleiben und darf nicht in den Ruhezustand gehen, sonst stoppt auch der Agent.
Docker Desktop installieren
Schon installiert, zum Beispiel für einen anderen Container? Dann diesen Schritt überspringen. Sonst lade Docker Desktop von docker.com herunter, installiere und starte es.
Öffne danach in Docker Desktop Settings → General und schalte „Start Docker Desktop when you sign in to your computer“ ein, damit der Agent nach einem Neustart wiederkommt.
Die Adresse dieses Rechners finden
Windows: Öffne PowerShell (Startmenü, „PowerShell“ tippen) und gib
ipconfigein. Nimm die IPv4-Adresse deines Netzwerkadapters (Ethernet oder WLAN), zum Beispiel192.168.1.50.Mac: Systemeinstellungen → Netzwerk → deine Verbindung zeigt die IP-Adresse.
Trag sie hier ein, der Befehl in Schritt 3 passt sich an:
Das sieht nicht nach einer Adresse in deinem Heimnetz aus (z. B. 192.168.1.50).
Den Agenten starten
Füge diese Zeile in PowerShell (Windows) oder Terminal (Mac) ein und drücke Enter. Passwort und Adresse stehen schon drin:
docker run -d --name allmyprinters-agent --restart unless-stopped -p 8090:8090 -e AMP_PASSWORD=DeinPasswort -e AMP_PORT=8090 -e AMP_LANG=de -e AMP_LAN_IP=192.168.1.50 -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestBeim ersten Start wird der Agent heruntergeladen, das kann ein, zwei Minuten dauern. Fragt Windows, ob Docker auf das Netzwerk zugreifen darf, erlaube es für private Netzwerke.
Prüfen, ob er läuft
In Docker Desktop unter Containers sollte
allmyprinters-agentals laufend erscheinen. Auf diesem Rechner erreichst du den Agenten unterhttp://localhost:8090. Weiter unten bei „Agent öffnen“.
Später aktualisieren
Diese Zeile in PowerShell oder Terminal ausführen. Sie lädt die neueste Version und startet den Agenten neu. Deine Daten bleiben:
docker pull ghcr.io/nolimitek/allmyprinters-agent:latest; docker rm -f allmyprinters-agent; docker run -d --name allmyprinters-agent --restart unless-stopped -p 8090:8090 -e AMP_PASSWORD=DeinPasswort -e AMP_PORT=8090 -e AMP_LANG=de -e AMP_LAN_IP=192.168.1.50 -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestAgent entfernen
Stoppt und entfernt den Agenten. Deine Daten bleiben:
docker rm -f allmyprinters-agentUm auch alle seine Daten zu löschen. Das lässt sich nicht rückgängig machen:
docker volume rm allmyprinters-agentHome Assistant OS (App)
Braucht Home Assistant OS oder eine Supervised-Installation. Läuft dein Home Assistant selbst in Docker, folge stattdessen auf diesem Rechner den Linux-Schritten. Das Passwortfeld oben brauchst du hier nicht, die Anmeldung übernimmt Home Assistant.
Repository hinzufügen
Klick auf den Knopf. Dein Home Assistant öffnet sich und fragt, ob das AllMyPrinters-Repository hinzugefügt werden soll. Mit Hinzufügen bestätigen.
Dafür musst du in diesem Browser bei Home Assistant angemeldet sein. Sonst in Home Assistant den App-Store öffnen, oben rechts ⋮ → Repositories, und diese Adresse eintragen:
https://github.com/nolimitek/ha-allmyprintersApp installieren
App-Store neu laden und AllMyPrinters Agent öffnen. Installieren, dann Starten, und In Seitenleiste anzeigen einschalten.
Öffnen
In der Seitenleiste auf AllMyPrinters klicken. Das ist der Agent, mit Druckern, Spulen und Einstellungen wie in der App. Den Schritt „Agent öffnen“ unten kannst du überspringen.
Optional: Entitäten und Dashboards
Für Drucker, Spulen, Kamera und Pause/Abbrechen als Entitäten installierst du in HACS die Integration AllMyPrinters (benutzerdefiniertes Repository, dieselbe Adresse wie oben, Typ Integration) und startest Home Assistant neu. Sie erscheint dann unter Einstellungen → Geräte & Dienste → Entdeckt, du bestätigst sie nur noch.
Später aktualisieren
Updates bietet Home Assistant unter Einstellungen → Updates an, wie bei jeder anderen App. Deine Daten bleiben und sind Teil deiner Home-Assistant-Sicherungen.
Agent entfernen
Einstellungen → Apps → AllMyPrinters Agent → Deinstallieren. Dabei werden auch die Daten des Agenten in Home Assistant gelöscht. Wenn du sie behalten willst, vorher im Agenten unter Einstellungen → Sicherung als Datei sichern.
Danach, auf jedem System
Agent öffnen
Öffne auf einem beliebigen Rechner, Tablet oder Handy in deinem Heimnetz im Browser
http://<Adresse>:8090, zum Beispielhttp://192.168.1.50:8090. Melde dich mit deinem Passwort an und speichere die Seite als Lesezeichen.Die App verbinden
Im Agenten: Mehr → Einstellungen → Geräte koppeln → Gerät hinzufügen. Ein QR-Code erscheint, 10 Minuten gültig.
In der App: Mehr → Einstellungen → Mit Agent verbinden → QR-Code scannen.
Danach fragt die App, welche Daten bleiben sollen. Sind deine Drucker und Spulen schon in der App, wähle Daten der App übernehmen: Dann zieht alles zum Agenten um. Du brauchst die App ab Version 0.8.1.
Weitere Drucker hinzufügen
Drucker, die noch nicht in der App sind, fügst du im Agenten hinzu wie in der App: Die Suche schaut dein Netzwerk durch, und die Anleitung je Marke sagt dir, was du am Drucker einschalten musst.
Wenn du willst: Zugriff von unterwegs
Im Agenten: Mehr → Einstellungen → Zugriff von unterwegs → Einschalten. Dann erreichen deine gekoppelten Geräte den Agenten auch unterwegs, und am PC oder iPhone öffnest du ihn unter allmyprinters.com/web. Bis du es einschaltest, bleibt es aus, und alles ist Ende-zu-Ende verschlüsselt.
Wenn du willst: Home Assistant
Drucker, Spulen, Filamentboxen und Kamera in Home Assistant: Installiere in HACS die Integration AllMyPrinters (benutzerdefiniertes Repository
https://github.com/nolimitek/ha-allmyprinters, Typ Integration). Danach unter Einstellungen → Geräte & Dienste hinzufügen, mit der Adresse des Agenten und dem Schlüssel aus Mehr → Einstellungen → Home Assistant im Agenten.
Etwas klappt nicht?
„permission denied“
Setze sudo vor den Befehl. In unseren Linux-Befehlen steht es schon drin.
„The container name … is already in use“
Der Agent ist schon installiert. Um ihn mit neuen Einstellungen zu starten (etwa einem neuen Passwort), entferne zuerst den alten Container mit sudo docker rm -f allmyprinters-agent (unter Windows, Mac und Unraid ohne sudo). Deine Daten bleiben. Dann den Startbefehl noch einmal ausführen.
„port is already allocated“ oder im Protokoll steht, der Port sei belegt
Ein anderes Programm nutzt Port 8090 schon. Trag oben eine andere Zahl ein, zum Beispiel 8091, entferne den Container (siehe oben) und starte ihn mit dem neuen Befehl. Danach öffnest du den Agenten mit dem neuen Port.
„no matching manifest“ oder „exec format error“
Auf dem Gerät läuft ein 32-Bit-System, der Agent braucht 64 Bit. Auf einem Raspberry Pi 3, 4 oder 5 installierst du Raspberry Pi OS (64-bit).
Die Seite geht nicht auf
Prüfe, ob der Agent läuft (letzter Schritt bei deinem System) und ob Adresse und Port stimmen. Das Protokoll verrät oft den Grund: sudo docker logs --tail 30 allmyprinters-agent. Eine Firewall kann den Port sperren: unter Ubuntu mit ufw sudo ufw allow 8090/tcp ausführen, bei Synology den Port unter Systemsteuerung → Sicherheit → Firewall freigeben.
Ich habe das Passwort vergessen
Trag oben ein neues ein, entferne den Container (deine Daten bleiben) und starte ihn mit dem neuen Befehl. Bei Synology oder Portainer änderst du das Passwort im Compose-Text und aktualisierst Projekt oder Stack.
Die Suche findet meinen Drucker nicht
Trag ihn mit seiner IP-Adresse ein. Die steht im Display des Druckers oder in deinem Router. Unter Windows und Mac ist das bei Bambu Lab und Elegoo immer nötig.
Home Assistant OS, Proxmox, TrueNAS, OpenMediaVault, CasaOS?
Home Assistant OS: Nimm oben den Reiter Home Assistant, dort läuft der Agent als App. Proxmox: eine kleine Debian- oder Ubuntu-VM mit Docker anlegen und darin den Linux-Schritten folgen. TrueNAS SCALE, OpenMediaVault und CasaOS: per SSH eine Shell öffnen und den Linux-Schritten folgen, oder Portainer nehmen, falls vorhanden.
Kommst du nicht weiter?
Tippe in der App auf „Problem melden“ und beschreib, was passiert. Die letzten Zeilen des Protokolls helfen sehr: sudo docker logs --tail 30 allmyprinters-agent.