[TUT] Portainer - Installationsanleitung

Willi · December 14, 2024 at 6:06 PM

Liebe Forengemeinde,
da diese Frage oftmals auftritt, wie man denn nun Portainer auf dem NAS installieren kann, stelle ich Euch hier eine Schritt-für-Schritt-Anleitung zur Verfügung, mit welcher Ihr das Setup in wenigen Minuten durchführen könnt.

This image is exclusive to our members!
Please log in or register for free to view graphics and attachments.

Was ist Portainer?
Portainer ist eine Container Management Software, mit der Container ausgerollt, geändert und überwacht werden können.

Vorbereitung:
Das Entwicklerteam von Ugreen hat die Standardports für http (9000) und https (9443) aus meiner Sicht leider etwas unglücklich gewählt. Es empfiehlt sich daher, diese in UGOS zu ändern, beispielsweise analog zu Synology:

Systemsteuerung > Geräteverbindung > Porteinrichtung > Webpage-Port für http und https ändern

Installationsanleitung:

Consolenfenster öffnen und per ssh auf Euer NAS verbinden (ssh muss natürlich am NAS aktiviert sein)
Als Admin anmelden
Folgende Befehle ausführen:
- sudo -i
  - docker volume create portainer_data
  - docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest
Anschließend kann "Portainer" wie folgt erreicht werden: https://IP-Adresse-des-NAS:9443 (z.B. https://192.168.178.99:9443)
"Username" und "Password" für den Admin-Benutzer eingeben
"Create user" anklicken
Es erscheint u.U. die Meldung, dass Portainer neu gestartet werden muss, in diesem Fall zurück in das Consolenfenster wechseln und folgende Befehle ausführen:
- docker stop portainer
- docker start portainer
Browser öffnen, Portainer analog zu Schritt 4 aufrufen und mit den Daten aus Schritt 5 einloggen
"Get startet" anklicken und danach auf "Live Connect"
In der Linken Menüleiste auf "Containers" klicken
Nun siehst du alle Container, welche bereits auf dem NAS installiert sind

Weiterführende Informationen sind unter dem folgenden Link zu finden:

https://docs.portainer.io (Portainer Dokumentation)

Viel Spaß beim installieren!

columbo1979 · December 18, 2024 at 9:12 AM

Hallo,

bei mir klappt die Anleitung leider nicht:

Quote

PS C:\Users\colum> ssh toni@192.168.0.15
toni@192.168.0.15's password:
Linux NAS 6.1.27 #26 SMP PREEMPT_DYNAMIC Mon Nov 11 22:20:21 CST 2024 x86_64

The programs included with the Debian GNU/Linux system are free software;
the exact distribution terms for each program are described in the
individual files in /usr/share/doc/*/copyright.

Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
permitted by applicable law.
Last login: Wed Dec 18 08:54:01 2024 from 192.168.0.45
toni@NAS:~$ sudo -i
[sudo] password for toni:

BusyBox v1.35.0 (Debian 1:1.35.0-4+b3) built-in shell (ash)
Enter 'help' for a list of built-in commands.

root@NAS:~# docker volume create portainer_data
portainer_data
root@NAS:~# docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/d
ocker.sock -v portainer_data:/data portainer/portainer-ce:latest
docker: Error response from daemon: Conflict. The container name "/portainer" is already in use by container "3cd2f75ead02bd842139699d472c90709ae2a354e62c970c57899e762ce8dfa3". You have to remove (or rename) that container to be able to reuse that name.
See 'docker run --help'.
root@NAS:~#

Mike0185 · December 18, 2024 at 9:19 AM

Lt. der Meldung hast du schon einen Container der Porteiner heisst:

Quote

The container name "/portainer" is already in use by container

Willi · December 18, 2024 at 9:21 AM

↩ columbo1979
du hast in der Befehlszeile ein Leerzeichen drin (d ocker statt docker)...

Gehe nach dem sudo -i wie folgt vor:

sudo docker stop portainer
sudo docker rm portainer
Dann den Befehl in einer Wurst kopieren und einfügen:
docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest

columbo1979 · December 18, 2024 at 9:21 AM

den gab es auch mal... aber habe ja alles gelöscht...

im Log: docker shared folder: create fail

also das scheint alles noch nebenwirkungen mit dem wechsel auf der 6800 zu haben... habe nun docker gelöscht, neu installiert... verzeichnis gelöscht und wollte das docker verzeichnis neu erstellen: "konflikt mit dateinamen" kommt als fehlermeldung... hätte ich alles mal komplett neu gemacht... dann hätte man dieses basteln nun nicht...

columbo1979 · December 18, 2024 at 9:22 AM

root@NAS:~# docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/d
ocker.sock -v portainer_data:/data portainer/portainer-ce:latest
Unable to find image 'portainer/portainer-ce:latest' locally
latest: Pulling from portainer/portainer-ce
2a8c27161aa3: Pull complete
679061c2c821: Pull complete
d40df14c1d7a: Pull complete
8215717c7c10: Pull complete 542669febe7c: Pull complete
6c27c7f45b54: Pull complete
070d3bf2528e: Pull complete
846480e9f8b0: Pull complete
c7053d7d4c2a: Pull complete
a2ed6de7fb5f: Pull complete
4f4fb700ef54: Pull complete
Digest: sha256:f2a7f5abd4735f9cd91563c6134e014b15168c4018beea87f1eec9d9618b2ad4
Status: Downloaded newer image for portainer/portainer-ce:latest
dd4561c4b2f4b51e57be31f73d72748823145393548859add375a5903a353dda
docker: Error response from daemon: driver failed programming external connectivity on endpoint portainer (6596a1f135ecca6dd5c1f26eea243d3d376cf08294d4e4c43590269267141a3c): Error starting userland proxy: listen tcp4 0.0.0.0:9443: bind: address already in use.
root@NAS:~#

Willi · December 18, 2024 at 9:34 AM

Warum hast du denn docker gelöscht, wer hat dir das empfohlen? Und warum wolltest du das Docker Verzeichnis erstellen? Dieser Ordner wird bei der Installation von Docker automatisch erstellt. "Konflikt mit Dateiname" ist daher absolut korrekt, da "docker" ist ein reservierter Name ist. Jetzt sind natürlich alle deine Container unwiderruflich weg.

Quote

↩ columbo1979 hätte ich alles mal komplett neu gemacht... dann hätte man dieses basteln nun nicht...

Tut mir leid, aber wenn wir dir hier helfen wollen und du entgegen aller Empfehlungen solche Sachen machst, kann niemand etwas außer dir dafür 😉.

columbo1979 · December 18, 2024 at 9:35 AM

ja, das neu installieren ist auch nicht weiter wild... - mich nervt dieses basteln nur ohne erfolge.... bekomme es weiterhin nicht hin:

root@NAS:~# docker volume create portainer_data
portainer_data
root@NAS:~# docker stop portainer
portainer
root@NAS:~# sudo docker rm portainer
portainer
root@NAS:~# docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/d
ocker.sock -v portainer_data:/data portainer/portainer-ce:latest
56ae861719f553c6bb6d43f3a454303fc7e2efb0785e2fd878482416d1a38451
docker: Error response from daemon: driver failed programming external connectivity on endpoint portainer (7ddf27f4f69a4d34b09612d51058cd1debedd48031bd3b1151e29333cabe04e1): Error starting userland proxy: listen tcp4 0.0.0.0:9443: bind: address already in use.
root@NAS:~#

Willi · December 18, 2024 at 9:50 AM

↩ columbo1979
Auch kein Wunder, ich hab dir oben schon geschrieben dass du in der Codezeile ein Leerzeichen hast, das hier nicht hingehört. (d ocker statt docker).

Wenn ich deine Codezeile in einen Texteditor kopiere sieht das so aus:

Das Leerzeichen zwischen d ocker muss weg, dann klappts auch 😉

columbo1979 · December 18, 2024 at 9:51 AM

nein, ist auch kein Vorwurf - alles gut mich nervt nur zwischendurch das ganze basteln und möchte einfach, dass es auch mal funktioniert... - also nicht bös gemeint

hast du dazu noch ne idee?

root@NAS:~# docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/d
ocker.sock -v portainer_data:/data portainer/portainer-ce:latest
56ae861719f553c6bb6d43f3a454303fc7e2efb0785e2fd878482416d1a38451
docker: Error response from daemon: driver failed programming external connectivity on endpoint portainer (7ddf27f4f69a4d34b09612d51058cd1debedd48031bd3b1151e29333cabe04e1): Error starting userland proxy: listen tcp4 0.0.0.0:9443: bind: address already in use.

mein befehl ist (da ist kein leerzeichen):

root@NAS:~# docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest

dies scheint ja der fehler zu sein: Error starting userland proxy: listen tcp4 0.0.0.0:9443: bind: address already in use.

Mike0185 · December 18, 2024 at 9:57 AM

Quote

Error starting userland proxy: listen tcp4 0.0.0.0:9443: bind: address already in use.

Der Port 9443 wird vom System schon genutzt. Ersetz ihn mal durch zb. 9000

columbo1979 · December 18, 2024 at 9:59 AM

↩ Mike0185

super, mit port 9000 geht es danke euch!

Willi · December 18, 2024 at 10:15 AM

@"columbo1979"#14
Hast du dir die oben verlinkte Anleitung angeschaut?
Da steht mit Bildchen, dass 9443 geändert werden sollte auf z.B. 5001 - siehe Auszug:

tiger1989 · January 26, 2025 at 4:06 PM

Eine Anmerkung zu Punkt 7
ich habe docker run portainer durch "docker start portainer" ersetzt. Beim stoppen des Containers und erneuten starten via run gab es bei mir Probleme, dass das Image nicht gefunden wurde.

Ansonsten super Anleitung. Danke dafür.

Willi · January 26, 2025 at 4:12 PM

↩ tiger1989
Herzlich willkommen in unserer Community und vielen Dank für den Hinweis,
Du hast recht, ich habe die Anleitung dahingehend soeben korrigiert.

Kova0001 · February 26, 2025 at 7:30 PM

Hallo Willi,

ich versuche gerade erneut den Porainer zu installieren...

gestern habe ich schon einen Versuch gestartet, bin aber nicht weiter gekommen als zu Punkt 3...

Fehlermeldungen kamen bei der Installation keine vor!

...die in Punkt 4 beschriebene Möglichkeit des Zugriffs auf Portainer funktioniert bei mir nicht... Verbindung fehlgeschlagen...

ich habe 2 verschiedene Browser versucht, Firefox sowie Safari, weiter habe ich http://192.168.178.120:9443 und https://192.168.178.120:9443 versucht...

zumindest kann ich den Portainer im Terminal stoppen und starten... ist es normal das beide Befehle mehrere Minuten brauchen bis sich was regt?

Last login: Wed Feb 26 19:10:00 2025 from 192.168.178.111

Kovadmin@DXP4800PLUS:~$ sudo docker ps

[sudo] password for Kovadmin:

CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES

10363f970f10 portainer/portainer-ce:latest "/portainer" 25 minutes ago Up 11 minutes 0.0.0.0:8000->8000/tcp, :::8000->8000/tcp, 0.0.0.0:9443->9443/tcp, :::9443->9443/tcp, 9000/tcp portainer

Kovadmin@DXP4800PLUS:~$ sudo docker stop portainer

portainer

Kovadmin@DXP4800PLUS:~$ sudo docker start portainer

portainer

Kovadmin@DXP4800PLUS:~$ sudo docker ps

CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES

10363f970f10 portainer/portainer-ce:latest "/portainer" 36 minutes ago Up 58 seconds 0.0.0.0:8000->8000/tcp, :::8000->8000/tcp, 0.0.0.0:9443->9443/tcp, :::9443->9443/tcp, 9000/tcp portainer

Kovadmin@DXP4800PLUS:~$

Ich freue mich auf Unterstützung...

Willi · February 26, 2025 at 7:57 PM

Hallo Kova0001,

Mach nochmal bitte das hier (natürlich ohne 1, 2, 3, 4)...

Code

1. sudo docker stop portainer
2. sudo docker rm portainer
3. sudo docker volume rm portainer_data
4. docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest

Kova0001 · February 26, 2025 at 8:11 PM

Ich war jetzt 36 Minuten nicht am Rechner und hab einfach nochmal reload am Browser ausgelöst und jetzt wurde ich durchverbunden aber portainer sagt das ein Neustart der portainer Instanz notwendig ist…

Ich versuche einen Neustart…

Ich glaube die eeeewig langen Wartezeiten wären schon erwähnenswert 🤔

Willi · February 26, 2025 at 8:15 PM

Quote from Kova0001

portainer sagt das ein Neustart der portainer Instanz notwendig ist…

Das ist normal und wird unter Punkt 7 der Anleitung ausführlich beschrieben. Hier nochmal, wie du das erledigen kannst:

Code

sudo docker stop portainer
sudo docker start portainer

Quote from Kova0001

Ich glaube die eeeewig langen Wartezeiten wären schon erwähnenswert

Das ist nicht üblich, normalerweise geht das sehr zackig. Möglicherweise beschäftigt dein NAS irgendwas im Hintergrund?

Kova0001 · February 26, 2025 at 8:27 PM

Ich habe den Portainer Container über die Docker app neu gestartet... hat auch ein paar min gedauert und wieder ist portainer nicht über den Browser erreichbar...

Ja meine 4800plus ist noch beschäftigt mit dem Aufbau des Speicherpools... aber das ist sie laut dem Speichermanager noch die nächsten 52 Tage........... gäääähhhhnnn... das liegt so weit in der Zukunft, ich weiss garnicht ob ich dann noch am Leben bin 😂

Participate now!