AllMyPrinters

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.

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.

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

  1. 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 user durch deinen Benutzernamen auf dem Gerät und die Zahlen durch seine IP-Adresse (steht in der Geräteliste deines Routers):

    ssh [email protected]

    Beim ersten Verbinden tippst du yes. Beim Eintippen des Passworts erscheint nichts auf dem Bildschirm. Das ist normal, einfach Enter drücken.

  2. Prüfen, ob Docker installiert ist

    Füge das ein und drücke Enter:

    docker --version

    Du siehst etwas wie Docker version 27.3.1? Dann weiter mit Schritt 3. Du siehst command not found? Dann installiere Docker mit dieser Zeile, das dauert ein paar Minuten:

    curl -fsSL https://get.docker.com | sudo sh

    Auf einem Raspberry Pi zusätzlich uname -m eingeben. Da muss aarch64 stehen. Steht dort armv7l, läuft auf dem Pi ein 32-Bit-System: Installiere zuerst Raspberry Pi OS (64-bit).

  3. Den Agenten starten

    Füge diese Zeile ein. Dein Passwort von oben steht schon drin. Fragt sudo nach 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:latest

    Beim 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.

  4. Prüfen, ob er läuft, und die Adresse finden

    Füge das ein:

    sudo docker ps --filter name=allmyprinters-agent

    Unter STATUS sollte Up stehen, nach etwa einer Minute auch (healthy). Jetzt die Adresse des Geräts abfragen:

    hostname -I

    Die 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:latest
Agent entfernen

Stoppt und entfernt den Agenten. Deine Daten bleiben, du kannst ihn jederzeit wieder starten:

sudo docker rm -f allmyprinters-agent

Um 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-agent

Synology-NAS (DSM 7.2 oder neuer)

  1. 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.

  2. Einen Ordner anlegen

    Öffne die File Station. Lege im freigegebenen Ordner docker (den hat Container Manager angelegt) einen neuen Ordner allmyprinters-agent an.

  3. 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-agent

    Klicke 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.

  4. Prüfen, ob er läuft

    Unter Container sollte allmyprinters-agent als laufend angezeigt werden. Die Adresse ist die, mit der du DSM öffnest, ohne :5000, zum Beispiel 192.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-agent

Unraid

  1. Prüfen, ob Docker an ist

    Settings → Docker: „Enable Docker“ muss auf Yes stehen. Das ist von Haus aus so.

  2. Das Terminal öffnen

    Klicke oben rechts in der Unraid-Oberfläche auf das Terminal-Symbol >_.

  3. 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:latest

    Beim ersten Start wird der Agent heruntergeladen. Am Ende steht eine lange Zeile aus Buchstaben und Zahlen. Dann hat es geklappt.

  4. Prüfen, ob er läuft

    Im Reiter Docker steht allmyprinters-agent jetzt als gestartet. Unraid zeigt ihn als Container ohne Vorlage an, das ist in Ordnung. Die Adresse ist die deines Unraid-Servers, zum Beispiel 192.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:latest
Agent entfernen

Stoppt und entfernt den Agenten. Deine Daten bleiben:

docker rm -f allmyprinters-agent

Um auch alle seine Daten zu löschen. Das lässt sich nicht rückgängig machen:

docker volume rm allmyprinters-agent

Portainer

  1. Einen Stack anlegen

    Melde dich bei Portainer an, wähle deine Umgebung (meist local) und klicke auf Stacks → Add stack.

  2. 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-agent
  3. Starten

    Scrolle nach unten und klicke auf Deploy the stack. Portainer lädt den Agenten herunter und startet ihn, das kann eine Minute dauern.

  4. Prüfen, ob er läuft

    Unter Containers sollte allmyprinters-agent als running und nach etwa einer Minute als healthy erscheinen. Die Adresse ist die IP des Geräts, auf dem Portainer läuft, zum Beispiel 192.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.

  1. 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.

  2. Die Adresse dieses Rechners finden

    Windows: Öffne PowerShell (Startmenü, „PowerShell“ tippen) und gib ipconfig ein. Nimm die IPv4-Adresse deines Netzwerkadapters (Ethernet oder WLAN), zum Beispiel 192.168.1.50.

    Mac: Systemeinstellungen → Netzwerk → deine Verbindung zeigt die IP-Adresse.

    Trag sie hier ein, der Befehl in Schritt 3 passt sich an:

  3. 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:latest

    Beim 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.

  4. Prüfen, ob er läuft

    In Docker Desktop unter Containers sollte allmyprinters-agent als laufend erscheinen. Auf diesem Rechner erreichst du den Agenten unter http://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:latest
Agent entfernen

Stoppt und entfernt den Agenten. Deine Daten bleiben:

docker rm -f allmyprinters-agent

Um auch alle seine Daten zu löschen. Das lässt sich nicht rückgängig machen:

docker volume rm allmyprinters-agent

Home 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.

  1. 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.

    Zu Home Assistant hinzufügen

    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-allmyprinters
  2. App installieren

    App-Store neu laden und AllMyPrinters Agent öffnen. Installieren, dann Starten, und In Seitenleiste anzeigen einschalten.

  3. Ö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.

  4. 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

  1. Agent öffnen

    Öffne auf einem beliebigen Rechner, Tablet oder Handy in deinem Heimnetz im Browser http://<Adresse>:8090, zum Beispiel http://192.168.1.50:8090. Melde dich mit deinem Passwort an und speichere die Seite als Lesezeichen.

  2. 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.

  3. 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.

  4. 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.

  5. 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.