Liebe Forengemeinde,
in diesem Tutorial stelle ich Euch eine Anleitung zur Verfügung, mit welcher Ihr "Homepage" auf Eurem NAS installieren könnt. Voraussetzung für dieses Tutorial ist Portainer und ein konfiguriertes MacVlan.
Vorbereitung - Ermitteln von PUID und PGID:
- Consolenfenster öffnen und per ssh auf Euer NAS verbinden (SHH muss natürlich aktiviert sein)
- Als Admin anmelden
- Folgende Befehle ausführen:
- id -u (gibt die PUID zurück, im Beispiel 1000)
- id -g (gibt die PGID zurück, im Beispiel 10)
- PUID und PGID notieren, diese Werte brauchen wir gleich
Anleitung:
- Dateimanager öffnen
- In den Ordner docker wechseln
- Erstellen des Ordners "homepage"
- In den Ordner "homepage" wechseln
- Erstellen des Ordners "config"
- Dateimanager schließen
- Die Datei "homepage.yml" herunterladen und in einem Texteditor Eurer Wahl öffnen
- PUID und PGID gemäß eurer ermittelten Werte ändern
- Volume-Pfad unter "Volumes" anpassen
- Bei "ipv4_address" eine freie IP Eures MacVlans eintragen (z.B. 192.168.178.228)
- Portainer öffnen
- Im linken Menü "Stacks" anklicken
- Auf der rechten Seite "+ Add Stack" anklicken
- Bei "Name" "homepage" (oder den Namen Eurer Wahl) eintragen
- Den Inhalt in der Datei "homepage.yml" kopieren (Strg + A und danach Strg + C)
- Den Inhalt im Webeditor einfügen (Strg + V)
- Unter "Actions" auf "Deploy the Stack" klicken
- Der Container wird installiert und ist anschließend unter IP-Adresse:3000 (z.B. 192.168.178.228:3000) erreichbar
Sofern noch nicht vorhanden, sollte nun im App Center der Texteditor installiert werden (Abb.1), da die Konfiguration von "Homepage" hauptsächlich durch das editieren folgender Dateien erfolgt:
- services.yaml
- widgets.yaml
- bookmarks.yaml
Abb.1
Du findest diese Dateien im zuvor erstellten Verzeichnis "config" aus Schritt 5 unter
- Dateimanager > Freigegebener Ordner > docker > homepage > config
Informationen zur Konfiguration dieser Dateien findet Ihr unter den nachfolgenden Links.
- Konfiguration der Datei "services.yaml": https://gethomepage.dev/configs/services
- Konfiguration der Datei "widgets.yaml": https://gethomepage.dev/configs/service-widgets
- Konfiguration der Datei "bookmarks.yaml": https://gethomepage.dev/configs/bookmarks
Unzählige Icons für "Homepage" findet ihr unter https://github.com/walkxcode/dashboard-icons/tree/main/png
über das linke Suchfeld "Go to file" und einem anschließenden [Enter].
Nach entsprechender Konfiguration könnte "Homepage" z.B. so so aussehen:
Nun noch als Startseite im Browser Eurer Wahl einrichten und fertig.
Viel Spaß beim installieren!