Wer meinenletzten Beitrag zum Homelab Setup 2025 gelesen hat, weiß dass ich dortKomodo (externer Link) als GitOps-Werkzeug für meine Docker Compose Stacks einsetze. Das Prinzip dahinter ist gut: Git als Single Source of Truth, Renovate für automatische Version-Updates, und bei einem neuen Commit deployed Komodo die Änderungen auf das Zielsystem. Funktioniert im Grunde auch – aber Komodo hat mich mit einer Sache regelmäßig zur Weißglut gebracht: File Permissions. Das funktioniert einfach nicht konsistent. Entweder stimmen die Berechtigungen auf dem Host nicht, oder Komodo meckert beim Deployment, oder irgendwas dazwischen. Nach dem x-ten Mal hatte ich genug und wollte eine schlankere Lösung.

Die Anforderung ist dabei überschaubar: Wenn Renovate einen neuen Commit in das Repo pusht (nach meinem Merge des Pull Requests), soll die compose-Datei auf dem Server aktualisiert und die betroffenen Container neu gestartet werden. Kein Kubernetes, kein weiteres Framework. Einfach git pull und docker compose up.

Das Grundprinzip

Das Setup basiert auf drei Komponenten die zusammenspielen:

1. Gitea (externer Link) – mein selbst gehosteter Git-Server, auf dem die Compose-Dateien liegen
2. Renovate (externer Link) – überprüft alle vier Stunden per Cronjob die verwendeten Image-Tags gegen die jeweiligen Container-Registries und öffnet bei neuen Versionen automatisch Pull Requests. Ich merge den PR, der Commit landet aufmain.
3. webhook (externer Link) – ein einzelnes Go-Binary, das auf dem Zielserver einen HTTP-Endpunkt bereitstellt. Gitea feuert bei jedem Push einen Webhook dorthin, woraufhin das Deploy-Script ausgeführt wird.

Der Datenfluss sieht so aus:

Renovate erkennt neues Image-Tag
→ PR in Gitea
→ Merge
→ Gitea feuert Webhook
→ webhook-Binary ruft deploy.sh auf
→ git pull + docker compose up -d

Kein Polling, kein Daemon der irgendwelche Container-Registries beobachtet, kein Framework das eigene Meinungen zu File Permissions hat.

Warum nicht einfach Watchtower oder ein Cron-Script?

Bevor ich zu webhook gegriffen habe, hatte ich kurz zwei andere Ansätze im Kopf.

Watchtower (externer Link) überwacht laufende Container und zieht neue Images automatisch. Das Problem: Watchtower reagiert auf neue Images in der Registry, nicht auf Git-Commits. Wenn Renovate einen PR öffnet und ich den merge, hat Watchtower davon keine Ahnung – der zieht einfach irgendwann wenn er selbst nachschaut. Das passt nicht zu einem Setup bei dem Git die einzige Quelle der Wahrheit sein soll. Außerdem will ich den Merge-Zeitpunkt kontrollieren, nicht Watchtower.

Cron-Script mitgit fetch wäre die andere Möglichkeit – alle paar Minuten nachschauen ob es Änderungen gibt und dann deployen. Funktioniert, hat aber einen konzeptionellen Nachteil: Es ist Polling. Ich baue mit Gitea bereits eine Infrastruktur auf die Push-Events liefern kann, die sollte ich auch nutzen. Ein Webhook reagiert innerhalb von Sekunden, ein Cron-Job mit 5-Minuten-Intervall verzögert unnötig.

webhook ist der sauberste Weg: Event-getrieben, kein Extra-Daemon, ein einzelnes Binary ohne Abhängigkeiten.

Repo-Struktur

Ich habe pro Server ein eigenes Repository:

• apps-stack für dendocker01 – dort laufen Tools wiePaperless-ngx (externer Link) ,Immich (externer Link) ,Vaultwarden (externer Link) und ähnliches
• media-stack für denmedia01 – dort leben alle*arr-Container und was sonst noch zum Medien-Stack gehört

Jedes Repo enthält einfach diecompose.yaml sowie ggf. weitere Konfigurationsdateien die einzelne Anwendungen benötigen. Nichts Besonderes.

Renovate in den Repos

Renovate läuft selfhosted und überprüft per Cronjob alle vier Stunden die Image-Tags in den Compose-Dateien. Dafür reicht eine minimalerenovate.json im Repo-Root:

{"$schema":"https://docs.renovatebot.com/renovate-schema.json","extends": ["config:base"],"docker-compose": {"enabled":true }}

Renovate erkennt dann automatisch die Image-Tags in der Compose-Datei und öffnet PRs wenn eine neuere Version verfügbar ist. Bei Software die semantische Versionierung verwendet (alsomajor.minor.patch) lässt sich das besonders fein steuern – z. B. nur Patch-Updates automatisch mergen, bei Minor-Updates erst schauen was sich geändert hat.

Für Postgres-Container würde ich Renovate übrigens ausschließen. Major-Upgrades zwischen Postgres-Versionen erfordern einen manuellen Datenbankdump und -import, das soll mir kein Bot automatisch reinschießen.

webhook installieren und konfigurieren

webhook gibt es als einzelnes Binary, alternativ auch als Paket:

apt install webhook

Die Konfiguration liegt unter/etc/webhook/webhook.conf:

-id:deployexecute-command:/opt/scripts/deploy.shcommand-working-directory:/opt/media-stacktrigger-rule:match:type:payload-hmac-sha256secret:"{{getenv \"WEBHOOK_SECRET\"}}"parameter:source:headername:X-Gitea-Signature

Ein paar Anmerkungen dazu:

Header-Name: Gitea schickt die Signatur alsX-Gitea-Signature – ohne-256-Suffix und ohnesha256=-Präfix im Wert. Das klingt trivial, hat mich aber beim ersten Versuch einen Debugging-Durchgang gekostet.

Secret als Umgebungsvariable: Das HMAC-Secret gehört nicht im Klartext in die Konfigurationsdatei, erst recht nicht wenn die Datei im Repo versioniert ist. Deshalb wird es pergetenv aus der Umgebung gelesen.

Das Secret generieren:

openssl rand -hex32

Und in eine Secrets-Datei schreiben die nur root lesen kann:

# /etc/webhook/secrets.envWEBHOOK_SECRET=dein-generierter-string

chmod600 /etc/webhook/secrets.env

Systemd-Unit

# /etc/systemd/system/webhook.service[Unit]Description=Webhook ReceiverAfter=network.target[Service]User=teqqy # Hier den eigenen Usernamen eintragenEnvironmentFile=/etc/webhook/secrets.envExecStart=/usr/bin/webhook -hooks /etc/webhook/webhook.conf -port 9000Restart=on-failure[Install]WantedBy=multi-user.target

User=teqqy sorgt dafür dass der webhook-Daemon und damit auch das Deploy-Script nicht als root laufen. Das ist mir wichtig – Prozesse die nur git pull und docker compose up ausführen müssen haben nichts als root verloren. Den Usernamen natürlich durch den eigenen ersetzen; der User braucht Zugriff auf das Repo-Verzeichnis und muss Mitglied derdocker-Gruppe sein.

EnvironmentFile lädt diesecrets.env und stelltWEBHOOK_SECRET als Umgebungsvariable bereit, bevor der Prozess startet – so kommt das Secret sauber in dengetenv-Aufruf der Konfiguration.Restart=on-failure sorgt dafür dass der Daemon bei einem unerwarteten Absturz automatisch neu startet, ohne dass man manuell eingreifen muss.

systemctl enable --now webhook

Gitea Webhook einrichten

In Gitea unterRepository → Einstellungen → Webhooks → Webhook hinzufügen → Gitea:

• Ziel-URL:http://media01.example.com:9000/hooks/deploy
• Secret: denselben String den du oben generiert hast
• Trigger: NurPush-Events reichen aus

Gitea berechnet bei jedem Push automatisch eine HMAC-SHA256-Signatur über den Request-Body und schickt sie alsX-Gitea-Signature-Header mit. Das webhook-Binary verifiziert die Signatur bevor es das Script ausführt – ein simpler Authorization-Header wäre hier deutlich unsicherer, weil man den Payload damit nicht gegen Manipulation absichert.

Port 9000 sollte nicht direkt ins Internet exponiert sein. In meinem Setup sind Gitea und der webhook-Daemon im selben internen Netz, der Port ist von außen nicht erreichbar. Wer den Endpunkt für eine externe Gitea-Instanz oder GitHub erreichbar machen muss, sollte das zumindest hinter einem Reverse Proxy mit IP-Beschränkung tun.

Das Deploy-Script

#!/bin/bashset -euo pipefailREPO=/opt/media-stackLOG=/opt/deploy-logs/deploy-$(date +%Y%m%d-%H%M%S).logexec >>"$LOG" 2>&1echo"=== Deploy$(date) ==="cd"$REPO"git pull origin maindocker compose up -d --remove-orphansdocker compose psecho"=== Done ==="

set -euo pipefail sorgt dafür dass das Script bei jedem Fehler sofort abbricht und einen Exit-Code ≠ 0 zurückgibt. Den loggt webhook dann ebenfalls, sodassjournalctl -u webhook bei Problemen der erste Anlaufpunkt ist.

Das Log-Verzeichnis muss dem ausführenden User gehören:

mkdir -p /opt/deploy-logschown teqqy:teqqy /opt/deploy-logs

Stolpersteine die ich unterwegs getroffen habe

.git-Verzeichnis Ownership: Wenn das Repo irgendwann mal als anderer User geklont oder gepullt wurde, verweigert Git den Zugriff mit einer Warnung zu “dubiosen Besitzverhältnissen”. Fix:

chown -R teqqy:teqqy /opt/media-stack/.git

safe.directory: In manchen Setups hilft zusätzlich:

git config --global --add safe.directory /opt/media-stack

/var/log Permissions: Der ausführende User hat dort keine Schreibrechte. Deshalb das Log-Verzeichnis in einen Pfad legen der dem User gehört – ich nutze/opt/deploy-logs.

*arr-Container und UID/GID: Meine*arr-Container laufen mit99:100 (Unraid-kompatibel wegen NFS). Beim allerersten Deployment legt Docker die Bind-Mount-Verzeichnisse mit1000:1000 an wenn sie noch nicht existieren. Einmalig vor dem ersten Start:

chown -R 99:100 /mnt/data/arr/

Danach ist das kein Thema mehr da die Verzeichnisse bereits existieren.

Monitoring

Ich setzeUptime Kuma (externer Link) ein und beobachte dort ob die Container nach einem Deployment noch sauber laufen. Das reicht für meinen Use Case: Wenn ein Container nach einem fehlgeschlagenen Update nicht mehr antwortet, schlägt Uptime Kuma an. Das deploy.log undjournalctl -u webhook liefern dann die Details warum es schiefgelaufen ist.

Ein Dead-Man’s-Switch (z. B. über Healthchecks.io) wäre der nächste sinnvolle Schritt wenn man auch merken will wenn ein Deploy einfachausbleibt – aber für einen Media-Stack ist das für mich nicht kritisch genug um extra Aufwand zu treiben.

Fazit

Das Setup ist jetzt seit kurzem in Betrieb und macht genau was es soll – ohne dass ich irgendwas an Komodo debuggen muss. Das webhook-Binary ist stabil, der Deployment-Flow ist deterministisch, und der Gesamtoverhead beschränkt sich auf ein paar Konfigurationsdateien und ein Shell-Script.

Wer ähnliche Anforderungen hat und kein Kubernetes betreiben möchte: Das ist meiner Meinung nach der pragmatischste Weg. Keine Magie, keine Frameworks, kein Overengineering. Nur git pull und docker compose up.

Bei Fragen oder Anmerkungen erreichst du mich über die Links in der Menüleiste.

Wie langjährige Leser meines Blogs oder Zuschauer meines YouTube Kanals wissen, nutze ich primär Traefik als Reverse Proxy unter Docker. Über die letzten Jahre hat sich entsprechend etwas an Know how angesammelt. Durch einenBeitrag (externer Link) auf Mastodon vonThomas Leister (externer Link) bin ich darauf gekommen auch mal http3 zu aktivieren. Was du entsprechend tun musst, um das bei dir ebenfalls einzurichten habe ich hier aufgeschrieben.

Vorteile von http3

HTTP/3 (externer Link) ist die neueste Version des Hypertext Transfer Protocols (HTTP) und bringt mehrere Vorteile gegenüber seinen Vorgängerversionen, insbesondere HTTP/1.1 und HTTP/2, mit sich. Hier sind einige der wichtigsten Vorteile von HTTP/3:

1. Schnellerer Verbindungsaufbau: HTTP/3 verwendet dasQUIC (externer Link) -Protokoll (Quick UDP Internet Connections), das auf UDP (User Datagram Protocol) basiert. Im Vergleich zu TCP (Transmission Control Protocol), das in vorherigen HTTP-Versionen verwendet wurde, ermöglicht QUIC einen schnelleren Verbindungsaufbau. Es beseitigt die Latenz, die durch den sogenannten “Handshake” in TCP verursacht wird.

2. Multiplexing ohne Head-of-Line-Blocking: HTTP/3 unterstützt effizientes Multiplexing von Anfragen und Antworten. Im Gegensatz zu HTTP/1.1, bei dem eine Verbindung nur eine Anfrage gleichzeitig behandeln kann (Head-of-Line-Blocking), können bei HTTP/3 mehrere Anfragen und Antworten gleichzeitig übertragen werden. Dies verbessert die Effizienz und verkürzt die Ladezeiten von Webseiten.

3. Bessere Leistung bei Netzwerkproblemen: HTTP/3 wurde entwickelt, um besser mit Netzwerkproblemen umzugehen. Das QUIC-Protokoll ermöglicht es, Verbindungen beizubehalten, auch wenn sich die Netzwerkbedingungen ändern. Dies trägt dazu bei, dass die Leistung aufrechterhalten wird, selbst wenn es zu Paketverlusten oder Netzwerkwechseln kommt.

4. Adaptivität: HTTP/3 wurde entwickelt, um sich besser an verschiedene Netzwerkbedingungen anzupassen. Es kann sich automatisch an veränderte Latenzen und Bandbreiten anpassen, um eine optimale Leistung zu gewährleisten.

5. Verbesserte Sicherheit: HTTP/3 unterstützt standardmäßig Verschlüsselung durch Transport Layer Security (TLS). Die Integration von TLS in den Kern des Protokolls trägt zur Sicherheit der Datenübertragung bei.

6. Flexibilität: HTTP/3 ist so konzipiert, dass es besser mit den Anforderungen moderner Webanwendungen und Dienste umgehen kann. Durch die kontinuierliche Entwicklung des Protokolls können zukünftige Anforderungen besser erfüllt werden.

Es ist wichtig zu beachten, dass die Einführung von HTTP/3 nicht nur von den Vorteilen, sondern auch von der Unterstützung auf Server- und Clientseite abhängt. Nicht alle Webserver und Browser unterstützen möglicherweise bereits HTTP/3, aber die Akzeptanz nimmt stetig zu.

Anpassen der traefik Konfiguration

Ich verwendet primär dietraefik.yml Datei um alles zu konfigurieren. Nutzt du mehr Labels, musst du das natürlich umbauen. Mit traefik 2.11 und 3 muss noch die experimentelle Funktion aktiviert werden. Dies kann zu einem späterern Zeitpunkt nicht mehr notwendig sein.

experimental:http3:true

Nun sind noch die Entrypoints anzupassen. meiner heißtwebsecure für die Verbindung von https. Entsprechend brauchen wir hier nur

http3:advertisedPort:'443'

hinzuzufügen. Der vollständigkeit halber sieht mein kompletter Block so aus:

entryPoints:ping:address:':88'web:address:':80'http:redirections:entryPoint:to:websecurescheme:httpswebsecure:address:':443'http:http3:advertisedPort:'443'proxyProtocol:trustedIPs:-10.0.0.0/8-172.16.0.0/12-192.168.0.0/16forwardedHeaders:trustedIPs:-10.0.0.0/8-172.16.0.0/12-192.168.0.0/16

Natürlich reicht das nicht ganz aus. Wie ihr seht, veröffentliche ich Port443 um http3 auszuliefern. Da http3 aber via QUIC über UPD kommuniziert, muss auch diedocker-compose.yaml Datei angepasst werden.

Die Portkonfiguration sieht dann entsprechen so aus:

ports:-target:80published:80protocol:tcpmode:host-target:443published:443protocol:tcpmode:host-target:443published:443protocol:udpmode:host

Der letztetarget Block ist der wichtige. Hier wird Port 443 auf udp ausgeliefert. Abschließend noch den Container neu starten

docker compose rm -sf&& docker compose up -d

Solltest du mehr als nur Traefik in der Datei haben, werden diese Services entsprechend auch neu gestartet. Ich empfehle zukünftig traefik zu separieren.

Du willst deine RSS-Feeds selbst verwalten, ohne auf Drittanbieter angewiesen zu sein?FreshRSS ist ein kostenloser, selbst gehosteter RSS-Reader, der dir volle Kontrolle über deine Nachrichtenquellen gibt. Die Open-Source-Software lässt sich in wenigen Minuten mit Docker installieren und funktioniert perfekt mit Apps wie Reeder (iOS) oder FeedMe (Android).

In dieser Anleitung zeige ich dir Schritt für Schritt, wie du FreshRSS einrichtest – von der Docker-Installation über das Importieren bestehender Feeds bis zur Einbindung mobiler Apps. Das Beste daran: FreshRSS bietet einevollständige API-Unterstützung, sodass du deine Feeds überall synchronisiert nutzen kannst.

Für mich persönlich war genau dieses API-Feature der entscheidende Grund, auf FreshRSS zu setzen. Nach Jahren der Nutzung kann ich sagen: Es ist die zuverlässigste selbst gehostete RSS-Lösung, die ich kenne.

Diejenigen die immer noch RSS nutzen wissen es sehr zu schätzen. Es gibt zwar mittlerweile viele Dienste die einen über neue Informationen auf Seiten benachrichtigen, aber wenn man „nur“ Blogs liest ist das Abonnement von RSS Feeds die wohl bessere Wahl. Feedreader, eines der alten Google Produkte, war sicherlich ein Vorreiter auf diesem Gebiet. Im laufe der ganzen Jahre kamen und gingen dann viele andere Produkte und Onlinedienste. Ich setze schon seit Jahre auf eine selbst gehostete Variante mitFreshRSS (externer Link) .

In der Szene der Open Source RSS Tools gibt es natürlich viele weitere Programme die sicherlich auch alle sehr gut sind. Für mich gab es nie den Grund mir andere detaillierter anzusehen da ich mit FreshRSS sehr gut zurecht komme. Zudem bietet es ein Feature an, dass für mich ein entscheidendes Kriterium ist. Dazu aber später noch mehr.

Installation von FreshRSS

Wie viele andere Softwareprodukte, die ich hier vorstelle, kann FreshRSS auch unter Docker installiert werden. Glückerlicherweise gibt der Entwickler einem die Wahl ob man mit der integrierten SQLite arbeiten möchte, oder eine MySQL bzw. PostgresDB Datenbank anbinden möchte. Je nachdem wie die heimische Infrastruktur so aufgestellt ist, empfiehlt sich das eine oder andere mehr.

Für diejenigen die nichts mit Docker oder Containerisierung anfangen können, gibt es sogar noch die klassische Installation. Allerdings möchte ich in diesem Beitrag eher auf die Variante in Docker zurückgreifen.

FreshRSS mit Docker Compose

Ich habe hier mal einedocker-compose.yaml Datei vorbereitet die mit PostgresDB als Datenbankbackend arbeitet. Eine Anpassung auf MySQL/MariaDB ist recht einfach vorzunehmen. Lassen wir die DB weg, können wir auch einfach bei der Installation die SQLite Variante auswählen.

---services:freshrss-db:image:postgres:17container_name:fressrss-dbrestart:unless-stoppedvolumes:-/etc/localtime:/etc/localtime:ro-/etc/timezone:/etc/timezone:ro-/var/docker/freshrss/db:/var/lib/postgresql/dataenvironment:-POSTGRES_USER=freshrss-POSTGRES_PASSWORD=${POSTGRES_PASSWORD}-POSTGRES_DB=freshrssfreshrss-app:image:freshrss/freshrss:latestcontainer_name:freshrss-apprestart:unless-stoppeddepends_on:-freshrss-dbvolumes:-/etc/localtime:/etc/localtime:ro-/etc/timezone:/etc/timezone:ro-/var/docker/freshrss/data:/var/www/FreshRSS/data-/var/docker/freshrss/extensions:/var/www/FreshRSS/extensionsenvironment:-CRON_MIN=*/20ports:-80:80

Wer das ganze mittels Traefik auch sauber mit Zertifikaten etc hosten möchte, verweise ich einfach auf meinevorbereitete Version auf GitHub (externer Link) .

Webinstallation

Leider müssen wir noch ein paar Schritte unternehmen um den RSS-Reader wirklich komplett installieren zu können. Die Installation erkennt nicht die Datenbankparameter oder ähnliches sodass wir die Schritte manuell durchführen müssen.

Sobald das alles durch ist, können wir uns mit den Zugangsdaten anlegen die wir anfangs angegeben haben. Unser erster Nutzer ist nämlich direkt Administrator der Seite.

Erste Schritte nach der Installation

Grundsätzlich kann die Software direkt verwendet werden. Allerdings habe ich noch einen kleinen Tipp der das Leben im Nachgang einfacherer macht. Wer nämlich wie ich die Feeds nicht über den Browser konsumieren möchte, sondern mittels eine Anwendung muss die API frei schalten. Dafür gehen wir rechts oben auf das Zahnrad und dann auf Authentifizierung. Hier setzen wir das Häkchen bei * API-Zugriff erlauben (für mobile Anwendungen benötigt)* und klicken aufSpeichern Nun müssen wir noch das API Kennwort für unseren Nutzer festlegen. Das machen wir in unserem Profil das ihr links oben direkt findet. Im unteren Bereich unterAPI-Verwaltung tragt ihr einfach ein Passwort ein. Sicherer wäre es, wenn ihr ein anderes verwendet als für euren Login.

Nutzung von FreshRSS

Löschen des FreshRSS Feeds (optional)

Nachdem wir die grundlegenden Schritte durchgeführt haben, können wir endlich die Software nutzen. Wir sollten zurück zur Startseite gehen - Klick links oben auf den Produktnamen. Anschließend wählen wir die ** Abonnementverwaltung** aus. Hier sollte bis auf den Feed der Software selbst nichts weiteres angezeigt werden.

Wenn ihr den Feed nicht benötigt, könnt ihr den natürlich löschen. Mit einem Klick auf das Zahnrad und dann rechtsEntfernen.

Import von bestehenden RSS Abonnements (optional)

Natürlich kann man auch von seinem bestehenden RSS Feedreader die Feeds importieren. Also zumindest solange der bisherige auch ein Export in zum Beispiel OPML Format unterstützt. Alles mir bisher gängigen haben das beherrscht. Hierzu klicken wir wieder aufAbonnementverwaltung und dann auf **Importieren / Exportieren **. Nun können wir rechts eine Datei unterImportieren auswählen und aufImportieren klicken.

Feeds hinzufügen

Um neue Feeds hinzuzufügen, wie zum Beispiel den von teqqy.de, klickt man links oben auf das+ Symbol. Anschließend kopiert man die Feed-URL in das Feld und klickt aufHinzufügen Wer möchte, kann natürlich vorher noch eineKategorie erstellen um gegebenenfalls eine größere Menge an Feeds besser zu verwalten.

3rd Party Apps

Da meine primären Endgeräte auf Apple Basis laufen, kann ich hier leider keine große Liste aufzeigen die ich empfehlen kann. Falls jemand ein guten RSS Client kennt der mit FreshRSS zusammen arbeitet, kann er mir den Tipp gerne zukommen lassen.

MacOS und iOS/iPadOS

Unter den Betriebssystemen verwende ich seit JahrenReeder (externer Link) als RSS Reader App. Mittlerweile in Version 5 angekommen hatte es mich immer gut begleitet. Seit in einer der letzten Versionen auch eine korrekte Unterstützung von FreshRSS via API hinzugekommen ist, war natürlich ein weiterer Grund auf die Liste gekommen.

Um Reeder einzurichten brauchen wir wieoben beschrieben einAPI-Passwort. In Reeder selbst gehen wir dann aufAccounts undAdd Account. Ganz unten findet man dann FreshRSS zur Auswahl. Nun tragen wir die benötigten Daten ein und klicken aufSign in. Anschließend zieht sich Reeder alle Informationen und würde noch ungelesene Artikel anzeigen.

Häufig gestellte Fragen zu FreshRSS

Was ist FreshRSS?

FreshRSS ist ein kostenloser, Open-Source RSS-Reader, den du auf deinem eigenen Server installieren kannst. Anders als Cloud-Dienste behältst du die volle Kontrolle über deine Daten und Feeds.

Ist FreshRSS wirklich kostenlos?

Ja, FreshRSS ist komplett kostenlos und Open Source. Du benötigst lediglich einen Server oder Computer, auf dem du die Software installieren kannst. Es fallen keine Lizenzkosten an.

Welche Apps kann ich mit FreshRSS nutzen?

FreshRSS unterstützt verschiedene mobile Apps über seine API. Beliebte Optionen sind Reeder (iOS/macOS), FeedMe (Android) und NetNewsWire (iOS/macOS). Alle Apps, die mit Google Reader kompatibel waren, funktionieren meist auch mit FreshRSS.

Wie viel Speicherplatz benötigt FreshRSS?

Die Installation selbst benötigt etwa 50-100 MB. Je nach Anzahl deiner Feeds und gespeicherten Artikeln solltest du 500 MB bis 2 GB Speicherplatz einplanen. Bei sehr vielen Feeds können es auch mehr werden.

Kann ich FreshRSS ohne Docker installieren?

Ja, FreshRSS lässt sich auch klassisch per PHP auf einem Webserver installieren. Die Anforderungen sind: PHP 7.4+, Apache oder Nginx, und optional MySQL/PostgreSQL. Die Docker-Variante ist jedoch einfacher zu verwalten.

In den letzten Jahren habe ich immer wieder aus verschiedenen Gründen die Blogsoftware gewechselt. Dieses Mal bin ich von Wordpress zu Jekyll umgezogen. Mein Vorgehen und Gründe möchte ich in diesem Beitrag erläutern.

Was ist Jekyll?

Jekyll ist eine Blogsoftware bzw. ein sogenannter Static Site Generator. Primär wird Jekyll von GitHub Pages verwendet. Die meisten Tutorials die man so im Internet finden beziehen auch genau darauf. Grundlegend baut die Software Markdown-Dateien zu statischen HTML Dateien um diese mit einem einfachen Webserver ausliefern zu können. Im bequemsten Fall sogar mit dem integriertem.

Gründe für meinen Wechsel

Gründe könnten mannigfaltig sein. Schlussendlich läuft es aber darauf hinaus, dass Wordpress immer mächtiger wird. Das hat seine Vor- und Nachteile. Sicherlich ist es sehr praktisch für jeden Anwendungsfall Wordpress verwenden zu können, denn die verschiedenen Plugins und Themes machen das möglich. Viele großen Webseiten basieren auf Wordpress und mit dem notwendigen Know-How und Ressourcen lassen sich auch sehr Performance Webseiten bauen. Der Nachteil der Erweiterbarkeit liegt entsprechend auch in der Pflege und den Bemühungen einen guten Wert für den LCP zu erreichen. Mir ist es im Laufe der Zeit nicht gelungen einen guten Wert zu erreichen. Am HosterNetcup (externer Link) liegt es nicht, da ich hier auch verschiedene ausprobiert habe. Zudem bin ich im Moment dabei mich von verschiedenen großen Softwareprodukten zu trennen und auf freiere Software zu setzen.

In der Webentwicklung steht LCP für “Largest Contentful Paint”. Es handelt sich um eine wichtige Metrik für die Ladeleistung einer Webseite. LCP misst die Zeit, die benötigt wird, um den größten sichtbaren Inhalt im Viewport eines Nutzers während des Seitenladens zu rendern. Ein guter LCP-Wert ist wichtig, um sicherzustellen, dass Webseiten schnell und reibungslos geladen werden und Benutzer eine bessere Erfahrung haben. {:.note title=“Was ist LCP?”}

Installation von Jekyll

Die Installation von Jekyll kann unter verschiedenen Betriebssystemen durchgeführt werden. Allerdings ist Windows nicht mit dabei. Wenn man allerdings den Umweg über WSL2 geht, kann man der regulären Linux Installation für die verwendete Linux-Distribution folgen. In dieser Anleitung gehe ich erst mal auf die Installation unter MacOS ein, da ich persönlich dieses Betriebssystem verwende. Alternative Installationen finden sich natürlich in der offiziellen Dokumentation. Gern kann dort diese entsprechend verwendet werden.

Installation unter MacOS

Installation des Paketmanagers brew

MacOS Nutzer haben in der Regel schon den Paketmanagerbrew installiert. Falls du das noch nicht getan hast, lässt sich das mittels

/bin/bash -c"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

erledigen. Grundsätzlich sollte aber immer beim Ausführen von Programmen direkt aus dem Internet vorsichtig sein! Sobald das erledigt ist, brauchen wir jetzt den Ruby Installer denn Jekyll ist in der entsprechenden Programiersprache geschrieben.

Installation von ruby

brew install chruby ruby-install xz

Dies kann durchaus ein paar Minuten dauern, das ist nicht ungewöhnlich. Nun installieren wir noch ruby selbst.

ruby-install ruby 3.2.2

Beachte, dass die Version 3.2.2 die zum Zeitpunkt des Artikels die aktuellste Version ist, dass kann zum jetzigen Zeitpunkt anders sein. Der nächste Schritt ist, dass wir ruby und die ganzen Environment Variablen noch aktivieren und in die MacOS Konfiguration speichern

echo"source$(brew --prefix)/opt/chruby/share/chruby/chruby.sh" >> ~/.zshrcecho"source$(brew --prefix)/opt/chruby/share/chruby/auto.sh" >> ~/.zshrcecho"chruby ruby-3.2.2" >> ~/.zshrc# run 'chruby' to see actual version

Installation von Jekyll

Endlich kommen wir zu dem Punkt, dass wir Jekyll selbst installieren können.

gem install jekyll

Auch der Schritt kann einige Zeit lang brauchen. Anschließend haben wir Jekyll installiert.

Jekyll Webseite anlegen

Sobald wir also eine lauffähige Version von Jekyll haben, können wir nun eine Webseite anlegen. Wir suchen uns also einen entsprechenden Ordner aus in dem die Installation durchgeführt werden soll. Ich mache sowas immer in einem Unterordner in meinem Homeverzeichnis.

cd ~

Den Namen den wir im install Befehl mitgeben wird auch der Name des Ordners sein. Natürlich kann der Prozess beliebig oft ausgeführt werden, falls euch das nicht gefällt.

jekyll new blog

Es entsteht dann eine ungefähr solche Ausgabe

Running bundle install in /Users/teqqy/blog... Bundler: Fetching gem metadata from https://rubygems.org/............ Bundler: Resolving dependencies... Bundler: Fetching rouge 4.1.3 Bundler: Installing rouge 4.1.3 Bundler: Bundle complete!7 Gemfile dependencies,33 gems now installed. Bundler: Use`bundle info[gemname]` to see where a bundled gem is installed.New jekyll site installed in /Users/teqqy/blog.[21:31:33][cost 3.162s] jekyll new blog

Nun wechseln wir in das Verzeichnis und gucken mal was so für Dateien und Ordner dort hinterlegt sind.

[21:32:50][~/blog] ❱❱❱ ls -ltotal48-rw-r--r--1 teqqy staff41931 Jul 21:31 404.html-rw-r--r--1 teqqy staff130931 Jul 21:31 Gemfile-rw-r--r--1 teqqy staff205231 Jul 21:31 Gemfile.lock-rw-r--r--1 teqqy staff207931 Jul 21:31 _config.ymldrwxr-xr-x3 teqqy staff9631 Jul 21:31 _posts-rw-r--r--1 teqqy staff53931 Jul 21:31 about.markdown-rw-r--r--1 teqqy staff17531 Jul 21:31 index.markdown

Wie man sieht, sind das nicht viele Dateien. Nun sollten wir die_config.yml anpassen. Die Begriffe sollten selbsterklärend sein. Die Werte sind aber erst mal keine Pflicht. Um jetzt die HTML Dateien bauen zu lassen verwenden wir folgenden Befehl

jekyll serve

Es erscheinen diverse Fehlermeldungen und Warnungen auf Grund von veralteten Abhängigkeiten. Leider sind diese immer noch nicht sauber gefixt. Die letzte Ausgabe sollte etwas in der Art von

Run in verbose mode to see all warnings.done in 0.401 seconds. Auto-regeneration: enabledfor'/Users/teqqy/blog' Server address: http://127.0.0.1:4000/ Server running... press ctrl-c to stop.

Enthalten. Jetzt könnt ihr euren Browser öffnen und die URLhttp://127.0.0.1:4000 verwenden.

Wir brechen dann wieder den laufenden Server mitCTRL-C ab. Wenn wir jetzt nochmal die Verzeichnisse auflisten sehen wir, dass dort ein neuer Ordner_site erstellt worden ist.

[21:40:43][~/blog] ❱❱❱ ls -ltotal48-rw-r--r--1 teqqy staff41931 Jul 21:31 404.html-rw-r--r--1 teqqy staff130931 Jul 21:31 Gemfile-rw-r--r--1 teqqy staff205231 Jul 21:31 Gemfile.lock-rw-r--r--1 teqqy staff207931 Jul 21:31 _config.ymldrwxr-xr-x3 teqqy staff9631 Jul 21:31 _postsdrwxr-xr-x8 teqqy staff25631 Jul 21:35 _site-rw-r--r--1 teqqy staff53931 Jul 21:31 about.markdown-rw-r--r--1 teqqy staff17531 Jul 21:31 index.markdown

Dieser Ordner ist nun schlussendlich das wichtige. Dieser kann auf einen Webserver kopiert und ausgeliefert werden.

Webseite bereitstellen

Viele Tutorials im Internet verwenden denjekyll serve Befehl um die Webseite auszuliefern und richten einen Webserver wie NGINX oder apache2 als reverse proxy ein. Dies ist allerdings nicht der vom Hersteller empfohlene Weg. Ich für meinen Teil habe das Verzeichnis auf meinen Webserver kopiert und liefere es mit einem Nginx Docker-Container aus. Dieser hat entsprechende Traefik Labels, welches sich um die Zertifikate etc kümmert. Sicherlich kein Setup für jeden.

Nginx Docker Container

Meine verwendetedocker-compose.yaml Datei kannst du natürlich übernehmen wenn du möchtest. Du müsstest nur die Werte entsprechend anpassen.

---version:"3.8"services:nginx:image:nginxcontainer_name:nginxvolumes:-./_site:/usr/share/nginx/html-./nginx.conf:/etc/nginx/conf.d/www_nginx.conflabels:-"traefik.enable=true"-"traefik.http.middlewares.nginx-https.redirectscheme.scheme=https"-"traefik.http.middlewares.nginx-compress.compress=true"-"traefik.http.routers.nginx-http.entrypoints=web"-"traefik.http.routers.nginx-http.rule=Host(`www.example.com`) || Host(`example.com`)"-"traefik.http.routers.nginx-http.middlewares=teqqy-https@docker"-"traefik.http.routers.nginx.entrypoints=websecure"-"traefik.http.routers.teqqy.rule=Host(`www.example.com``) || Host(`example.com``)"-"traefik.http.routers.nginx.tls=true"-"traefik.http.routers.nginx.tls.certresolver=default"-"traefik.http.routers.nginx.middlewares=secHeaders@file"-"traefik.http.routers.nginx.middlewares=teqqy-compress"-"traefik.http.services.nginx.loadbalancer.server.port=80"networks:-teqqywp-traefik_proxynetworks:traefik_proxy:external:name:traefik_proxyteqqywp:driver:bridge

Nginx Konfiguration

Ich binde noch eine eigenenginx.conf Datei ein in der ich noch Anpassungen für Caching und anderes mache.

server {
listen 80;
server_name example.com www.example.com
root /usr/share/nginx/html;
index index.html index.htm;
if (!-f "${request_filename}index.html") {
rewrite ^/(.*)/$ /$1 permanent;
}
if ($request_uri ~* "/index.html") {
rewrite (?i)^(.*)index\.html$ $1 permanent;
}
if ($request_uri ~* ".html") {
rewrite (?i)^(.*)/(.*)\.html $1/$2 permanent;
}
error_page 404 /404.html;
location / {
try_files $uri $uri.html $uri/ =404;
}
location ~* \.(?:ico|css|js|gif|jpe?g|png)$ {
expires 30d;
add_header Pragma public;
add_header Cache-Control "public";
}
# reduce the data that needs to be sent over network -- for testing environment
gzip on;
# gzip_static on;
gzip_min_length 10240;
gzip_comp_level 1;
gzip_vary on;
gzip_disable msie6;
gzip_proxied expired no-cache no-store private auth;
gzip_types
# text/html is always compressed by HttpGzipModule
text/css
text/javascript
text/xml
text/plain
text/x-component
application/javascript
application/x-javascript
application/json
application/xml
application/rss+xml
application/atom+xml
font/truetype
font/opentype
application/vnd.ms-fontobject
image/svg+xml;
# allow the server to close connection on non responding client, this will free up memory
reset_timedout_connection on;
# request timed out -- default 60
client_body_timeout 10;
# if client stop responding, free up memory -- default 60
send_timeout 2;
# server will close connection after this time -- default 75
keepalive_timeout 30;
# number of requests client can make over keep-alive -- for testing environment
keepalive_requests 100000;
}

Nun kann der Container gestartet werden und nach kurzer Zeit könnt ihr die Seite über die angegebene URL aufrufen.

Wordpress Daten exportieren

Für den Export habe ich das Wordpress PluginWordpress to Jekyll Exporter (externer Link) verwendet. Es nicht das beste Plugin aber für mich hat es gereicht. In Wordpress können wir dann unterWerkzeuge den Export ausführen und bekommen eine ZIP-Datei zum Download. Die Inhalte können wir direkt in unser Jekyll Verzeichnis kopieren und die Seiten neu genierieren lassen.

jekyll serve

Nun können wir den Ordner_site wieder auf unseren Webserver kopieren. Den Container müssen wir nicht neu starten, denn nginx liefert die Dateien direkt aus. Ein einfacher reload im Browser reicht dafür aus.

Jekyll anapssen

Jetzt liegt es an euch, Jekyll entsprechend den Bedürfnissen anzu passen. Heißt ein Theme herunter zu laden oder mit Plugins zu erweitern.

Update Dezember 2025: Dieser Artikel wurde überarbeitet und berücksichtigt die wichtigen Änderungen der Tesla Fleet API sowie aktuelle Teslamate-Versionen.

Moderne Fahrzeuge bieten mittlerweile eine API-Schnittstelle, um alle möglichen Daten auslesen zu können. Tesla war einer der ersten Hersteller, der dies umfangreich zur Verfügung stellt. Entsprechend sind Softwareprodukte wie Teslamate entstanden. Teslamate ist ein selbstgehosteter Open-Source-Datenlogger, der deine Tesla-Daten kontinuierlich erfasst, speichert und mit Grafana visualisiert.

Was hat sich 2025 geändert?

Die wichtigsten Updates auf einen Blick:

Tesla Fleet API: Tesla hat die inoffizielle “Owner API” durch die offizielle Fleet API ersetzt. Seit Februar 2025 gilt ein Pay-per-Use-Modell mit monatlichem $10-Freikontingent. Für Privatnutzer mit 1-2 Fahrzeugen reicht das Kontingent meist aus, zusätzliche Kosten liegen bei etwa $2-5/Monat bei intensiver Nutzung.

PostgreSQL 17: Teslamate benötigt nun mindestens PostgreSQL 16.7 oder 17.3. Die Entwickler empfehlen PostgreSQL 17.

Fleet Telemetry: Neu ist die Möglichkeit, dass das Fahrzeug Daten direkt streamt. Das ist präziser und günstiger als klassisches Polling, aber komplexer in der Einrichtung. Fleet Telemetry erfordert einen eigenen Server-Endpunkt und TLS-Zertifikate. Die Daten werden dann vom Fahrzeug per WebSocket gestreamt, sobald sich Werte ändern. Das spart API-Kosten, da du nicht mehr aktiv pollen musst. Besonders bei Fahrten erhältst du hochfrequente Daten mit minimaler Latenz. Für die meisten Nutzer funktioniert das bewährte Polling jedoch weiterhin problemlos und ist deutlich einfacher einzurichten.

Teslamate – Installieren oder einkaufen?

Teslamate ist keine Software-as-a-Service, sondern wird vom Nutzer selbst installiert. Ob im heimischen Homelab oder auf einem VPS-Server in der Cloud, z. B. beiNetcup (externer Link) – beides funktioniert. Ich hoste die Software auf meinem eigenen Server im Heimnetzwerk.

Die Installation ist mitDocker sehr einfach. Du benötigst eine Datenbank (PostgreSQL) und den Anwendungscontainer. Für die Visualisierung setzt Teslamate auf Grafana mit fertig konfigurierten Dashboards.

Voraussetzungen

Hardware & Software:

• Server mit mindestens 2 GB RAM (Raspberry Pi 4/5, NAS, VPS)
• Docker und Docker Compose installiert
• Dauerhaft aktive Internetverbindung

Tesla-Account:

• Tesla-Konto mit Zwei-Faktor-Authentifizierung
• Tesla Developer Account (kostenlos beideveloper.tesla.com (externer Link) )

Tesla Developer Account einrichten

Seit der Umstellung auf die Fleet API brauchst du einen Developer Account:

1. Melde dich beideveloper.tesla.com (externer Link) mit deinem Tesla-Konto an
2. Erstelle eine neue Application (z.B. “Teslamate Homelab”)
3. Gib eine kurze Beschreibung an
4. Bei lokaler Nutzung kannst du localhost als Domain verwenden

Die Prüfung dauert ein paar Tage, für private Zwecke erfolgt die Freigabe normalerweise problemlos. Das monatliche $10-Guthaben ist ein echtes Guthaben – du musst keine Kreditkarte hinterlegen, solange du darunter bleibst.

Token-Erstellung

Früher funktionierte die Anmeldung mit Benutzerdaten. Heute benötigst du einen „Refresh Token" und „Access Token". Diese generierst du am einfachsten mit Apps:

• iOS: “Auth for Tesla” (Apple AppStore)
• Android: “Tesla Tokens” oder “Auth for Tesla”
• Windows/Mac: “Tesla Auth” oder Web-basierte Tools

Vorgehensweise:

1. App installieren und mit Tesla-Benutzernamen anmelden
2. Passwort eingeben
3. Beim zweiten Prompt deinen 2FA-Code eingeben (nicht nochmal das Passwort!)
4. App zeigt Refresh Token und Access Token – beide sicher aufbewahren

Die Tokens bleiben mehrere Monate gültig. Teslamate erneuert den Access Token automatisch.

Installation mit Docker Compose

Die einfachste Installation erfolgt über Docker Compose. Falls du Docker Compose noch nicht installiert hast:

# Auf Ubuntu/Debiansudo apt install docker-compose-plugindocker compose version

Erstelle ein Arbeitsverzeichnis:

mkdir ~/teslamate&& cd ~/teslamate

Ich verweise auf dieoffizielle Dokumentation (externer Link) , da sich die Konfiguration regelmäßig ändert.

Wichtige Anpassungen für 2025:

version:"3"services:teslamate:image:teslamate/teslamate:latestrestart:alwaysenvironment:-ENCRYPTION_KEY=dein_sicherer_schluessel-DATABASE_USER=teslamate-DATABASE_PASS=sicheres_passwort-DATABASE_NAME=teslamate-DATABASE_HOST=database-TZ=Europe/Berlin# Deine Zeitzone!-MQTT_DISABLE=true# Falls kein MQTT benötigtports:-4000:4000cap_drop:-alldatabase:image:postgres:17# Mindestens 16.7 oder 17.3!restart:alwaysenvironment:-POSTGRES_USER=teslamate-POSTGRES_PASSWORD=sicheres_passwort-POSTGRES_DB=teslamatevolumes:-teslamate-db:/var/lib/postgresql/datagrafana:image:teslamate/grafana:latestrestart:alwaysenvironment:-DATABASE_USER=teslamate-DATABASE_PASS=sicheres_passwort-DATABASE_NAME=teslamate-DATABASE_HOST=databaseports:-3000:3000volumes:-teslamate-grafana-data:/var/lib/grafanavolumes:teslamate-db:teslamate-grafana-data:

MQTT für Home Assistant:

Wenn du die Daten an einen MQTT-Server weiterleiten willst (z. B. fürHome-Assistant ), ersetzeMQTT_DISABLE=true durchMQTT_HOST=mosquitto und füge einen Mosquitto-Container hinzu.

Container starten:

docker compose up -d

Teslamate ist anschließend unterhttp://{IP-deines-Servers}:4000 erreichbar. Beim ersten Aufruf gibst du die zuvor generierten Tokens ein. Nach 1-2 Minuten (ggf. Fahrzeug mit der App aufwecken) sollten erste Daten angezeigt werden.

Auswertung mit Grafana

Ein großer Vorteil der vordefinierten Docker-Compose-Datei: Grafana ist direkt mit dabei. Grafana läuft standardmäßig unterhttp://{IP-deines-Servers}:3000.

Standard-Login (sofort ändern!):

• Benutzername:admin
• Passwort:admin

Grafana hat die PostgreSQL-Datenbank als Datenquelle bereits konfiguriert und alle Dashboards sind importiert. Bei Nutzung einer eigenen Grafana-Instanz musst du die JSON-Dateien aus demGitHub (externer Link) Repository manuell importieren.

Wichtige Dashboards:

• Overview: Gesamtübersicht aller Kennzahlen – der perfekte Einstieg
• Drives: Fahrtenauswertung mit interaktiven Karten, zeigt Route, Geschwindigkeit und Verbrauch
• Charges: Detaillierte Ladehistorie mit Kostenanalyse pro Ladevorgang, Vergleich verschiedener Ladestationen
• Battery Health: Langzeitentwicklung der Batteriekapazität, zeigt Degradation über Zeit und Kilometer
• Efficiency: Verbrauchsanalysen nach Geschwindigkeit, Temperatur, Höhenmetern – erkenne was deine Reichweite beeinflusst
• Vampire Drain: Standby-Verbrauch im geparkten Zustand, hilft Phantom Drain zu identifizieren
• Locations: Häufige Aufenthaltsorte, automatische Geofencing-Erkennung
• Updates: Historie aller Software-Updates mit Zeitstempeln

Langzeitnutzung und Erkenntnisse

Der wahre Wert zeigt sich nach mehreren Monaten. Hier konkrete Beispiele aus meiner Nutzung:

Batteriedegradation: Mein Model Y zeigte nach 50.000 km etwa 4% Kapazitätsverlust. Typisch sind 3-5% in den ersten 50.000 km, danach verlangsamt sich die Degradation deutlich. Mit Teslamate siehst du die exakte Entwicklung und kannst Ausreißer (z.B. durch BMS-Kalibrierung) erkennen.

Saisonale Unterschiede: Im Winter (Temperaturen um 0°C) liegt mein Verbrauch bei ca. 20-22 kWh/100km, im Sommer bei 15-17 kWh/100km. Das sind rund 30% Mehrverbrauch durch Heizung und kalte Batterie. Diese Daten helfen bei der Routenplanung.

Kostenoptimierung: Heimladen (0,30 €/kWh) vs. Supercharger (0,52 €/kWh) – der Unterschied summiert sich. Bei 15.000 km jährlich spare ich durch Heimladen etwa 400 € pro Jahr. Noch besser:PV-Überschussladen reduziert die Kosten auf ca. 0,08 €/kWh.

Effizienz: Überraschend war, dass mein optimaler Geschwindigkeitsbereich bei 90-110 km/h liegt, nicht wie erwartet bei 70 km/h. Unter 70 km/h steigt der relative Verbrauch durch Hilfsaggregate wieder leicht an.

Troubleshooting

Teslamate zeigt “offline” statt “asleep”: Das ist seit Tesla-Firmware 2024.8+ normal. Tesla hat die API-Rückmeldung geändert – kein Teslamate-Bug.

Token wird nicht akzeptiert: Verwende den Refresh Token (der längere der beiden Strings), nicht den Access Token.

Keine Daten: Prüfe die Docker-Logs mitdocker compose logs teslamate. Häufige Ursachen: Fahrzeug im Tiefschlaf, falsche Zeitzone, Netzwerkprobleme.

Hohe API-Kosten: Reduziere die Polling-Frequenz, nutze Fleet Telemetry oder prüfe auf unnötige Wake-Befehle.

Sicherheit und Backup

Netzwerk:

• Nicht direkt ins Internet exponieren
• Reverse Proxy mit HTTPS nutzen (Nginx, Caddy, Traefik)
• Firewall-Regeln aktivieren

Backup:

docker compose exec database pg_dump -U teslamate teslamate > backup.sql

Updates:

docker compose pulldocker compose up -d

Häufige Fragen

Kostet Teslamate Geld? Die Software ist kostenlos. Tesla API-Kosten fallen an, werden aber meist vom $10-Freikontingent abgedeckt. Nur bei intensiver Nutzung entstehen ca. $2-5/Monat zusätzlich.

Funktioniert es mit der neuen Fleet API? Ja, vollständig kompatibel und aktuell gehalten.

Entlädt es die Batterie? Nein, der Zusatzverbrauch ist vernachlässigbar.

Mehrere Fahrzeuge möglich? Ja, jedes wird separat erfasst.

Fazit

Teslamate ist für mich die beste Lösung für umfassende Fahrzeugdatenanalyse. Die Vorteile:

• Volle Datenkontrolle durch Self-Hosting
• Detaillierte Analysen mit Grafana
• Geringe Kosten dank Freikontingent
• Aktive Community
• Perfekt für Home-Assistant-Integration

Die Nachteile: Technisches Know-how erforderlich, eigener Server nötig, kein offizieller Support.

Für Tesla-Besitzer mit Smart-Home- oder Homelab-Affinität ist Teslamate eine hervorragende Software. Nach einigen Monaten Nutzung werden die Auswertungen besonders interessant, da sich Tendenzen und Langzeitentwicklungen zeigen. Selbst während der Fahrt liefern die Grafana-Dashboards diverse interessante Daten.

Tipps für Fortgeschrittene

Reverse Proxy Setup: Für sicheren Zugriff von unterwegs empfehle ich einen Reverse Proxy mit Let’s Encrypt SSL-Zertifikat. Traefik oder Caddy automatisieren den Prozess komplett.

Datenbank-Optimierung: Bei sehr alten Installationen kann ein manuelles Vacuum der Datenbank helfen:

docker compose exec database vacuumdb -U teslamate -d teslamate -z -v

Custom Dashboards: Grafana bietet unendliche Möglichkeiten. Du kannst beispielsweise Vergleiche mit anderen Tesla-Fahrern erstellen oder Korrelationen zwischen Wetter und Verbrauch visualisieren.

Weiterführende Links:

• Teslamate Dokumentation (externer Link)
• GitHub Repository (externer Link)
• Community Forum (externer Link)

In der heutigen Welt, in der Containerisierung und die Nutzung von Docker für viele Entwickler und IT-Experten zum Alltag gehören, ist es entscheidend, effiziente und benutzerfreundliche Tools zu haben, um diese komplexen Systeme zu verwalten. Hier kommtPortainer ins Spiel – ein leistungsstarkes und intuitives Verwaltungstool, das die Arbeit mit Docker-Containern und -Stacks erheblich vereinfacht. Portainer bietet eine grafische Benutzeroberfläche (GUI), mit der sowohl Anfänger als auch erfahrene Entwickler ihre Container, Images, Netzwerke und Volumes verwalten können, ohne tief in die Kommandozeile eintauchen zu müssen.

In diesemPortainer-Tutorial führen wir dich Schritt für Schritt durch die Installation, Einrichtung und die wichtigsten Funktionen des Tools. Egal, ob du gerade erst in die Welt der Containerisierung einsteigst oder bereits Erfahrung mit Docker hast – dieses Tutorial hilft dir, Portainer effektiv zu nutzen, um deine Container-Infrastruktur effizienter und übersichtlicher zu gestalten. Am Ende wirst du in der Lage sein, deine Docker-Umgebung problemlos zu überwachen, zu konfigurieren und zu steuern. Mach dich bereit, deine Docker-Workflows auf das nächste Level zu heben!

Voraussetzungen

Voraussetzungen für diesesPortainer (externer Link) Tutorial gibt es eigentlich fast keine. Wir beschränken uns in diesem Beitrag allerdings auf die Verwaltung von Docker. Entsprechend solltest du ein Linux-Server mit installiertem Docker vorbereitet haben. Alles weitere werden wir zusammen erarbeiten.

Installation von Portainer

Eine wirkliche Installation findet ja nicht statt. Wir starten Portainer als Docker Container und müssen uns eigentlich nur gegen diesen verbinden. Du findest eine vorgefertigte docker-compose.yaml-Datei inmeiner Compose-Sammlung (externer Link) . Die für die Docker GUI sieht zum Beispiel so aus.

---version:'3.3'services:portainer:image:portainer/portainer-ce:2.11.1container_name:portainerrestart:unless-stoppedvolumes:-/etc/localtime:/etc/localtime:ro-/etc/timezone:/etc/timezone:ro-/var/run/docker.sock:/var/run/docker.sock-/var/docker/portainer:/dataports:-9000:9000

Den Datenspeicherort der Portainer-Konfiguration kannst du dir natürlich nach Belieben anpassen (4. Zeile bei den Volumes). Anschließend können wir den Container auch schon starten.

docker compose up

Nach ein paar Sekunden sollte die Anwendung dann vollständig gestartet sein.

portainer | INFO 2022/03/22 18:18:21 Encryption key file `portainer` not present
portainer | INFO 2022/03/22 18:18:21 Proceeding without encryption key
portainer | INFO 2022/03/22 18:18:21 Loading PortainerDB: portainer.db
portainer | level=info msg="2022/03/22 18:18:21 [INFO] [internal,ssl] [message: no cert files found, generating self signed ssl certificates]"
portainer | 2022/03/22 18:18:22 server: Reverse tunnelling enabled
portainer | 2022/03/22 18:18:22 server: Fingerprint 8f:41:d0:fc:b7:fe:45:23:9d:f1:31:5d:70:f8:38:76
portainer | 2022/03/22 18:18:22 server: Listening on 0.0.0.0:8000...
portainer | INFO 2022/03/22 18:18:22 [INFO] [cmd,main] Starting Portainer version 2.11.1
portainer |
portainer | level=info msg="2022/03/22 18:18:22 [INFO] [http,server] [message: starting HTTPS server on port :9443]"
portainer | level=info msg="2022/03/22 18:18:22 [DEBUG] [chisel, monitoring] [check_interval_seconds: 10.000000] [message: starting tunnel management process]"
portainer | level=info msg="2022/03/22 18:18:22 [DEBUG] [internal,init] [message: start initialization monitor ]"
portainer | level=info msg="2022/03/22 18:18:22 [INFO] [http,server] [message: starting HTTP server on port :9000]"

Ab jetzt können wir mit der Einrichtung beginnen.

Einrichtung von Portainer

Hierzu öffnen wir einen neuen Tab im Browser (oder gern auch ein neues Fenster) und geben die IP-Adresse des Docker-Servers gefolgt vom Port ein. Uns sollte so etwas begrüßen.

Wenn du möchtest, kannst du den Administrator-Account gerne einen anderen Nutzernamen geben. Andernfalls lass einfach das „admin“ in der ersten Zeile stehen. Anschließend tippst du bitte zwei Mal ein selbst gewähltes Passwort ein. Nun noch unten auf „Create user“ klicken und schon erscheint der nächste Bildschirm.

Solltest du mehrere DockerServer damit verwalten wollen, wäre „Add Environment“ das Richtige. Allerdings wollen wir in diesem Portainer Tutorial lediglich den lokalen Docker Server verwalten. Wir klicken also auf „Get Started“ und landen direkt beim nächsten Fenster.

Es werden hier eine Liste der möglichen Docker-Umgebungen dargestellt. Da wir natürlich nur auf die Lokale Zugriff haben, können wir nur „local“ auswählen. Genau dieses wollen wir natürlich auch.

Anschließend ist die Einrichtung auch schon abgeschlossen.

Anwendungen hinzufügen

Docker Container bzw. die Anwendungen werden als Stack in Portainer verwaltet. Entsprechend ist die Benennung hier ein wenig anders als du das vielleicht gewohnt bist. In diesem Portainer Tutorial gehe ich auf zwei Methoden ein eine neue Anwendung hinzuzufügen, nämlich per copy & paste der docker-compose.yaml-Datei und per Import vonGitHub (externer Link) .

Per Copy & Paste

Diese Methode ist wohl die einfachste. Du kannst bestehende docker-compose.yaml-Dateien fast immer einfach hier rein kopieren. Allerdings ist aufzupassen, dass keine Variablen verwendet werden. Diese können in der Methodik nämlich nicht ausgefüllt werden. Gegebenenfalls ersetzt du einfach die Variablen durch die eigentlichen Werte, dann funktioniert das auch.

Als erstes vergeben wir einen Namen. Dieser Name ist eineindeutig für die jeweiligen Umgebungen. Zudem dürfen keine Umlaute oder Leerzeichen verwendet werden. Binde- oder Unterstriche, wie im Beispiel zu sehen, sind natürlich erlaubt.

Für dieses Beispiel deployen wir das Ghost CMS. Wir nehmen also einfach eine docker-compose.yaml-Datei (wie diese aus meiner Sammlung) und fügen den Inhalt einfach ein.

In unserem einfachen Beispiel müssen wir nichts weiter beachten und lassen alle anderen Felder und Möglichkeiten außer Acht. Wir müssen also nur noch auf „Deploy the stack“ klicken und Portainer zieht das Image aus der Registry und startet den Container.

So einfach war die Copy & Paste-Methode. Anschließend fügen wir jetzt noch eine compose-Datei ausGitHub (externer Link) hinzu.

Compose Datei aus GitHub

Diese Methode kann verwendet werden, wenn man keine Lust auf Copy & Paste hat. Allerdings hat sie nicht wirklich große Vorteile. Zumal der Stack dann auch nicht vollständig über Portainer verwaltet werden kann. Auf der anderen Seite wird der Stack über die originale Datei auf GitHub synchronisiert und entsprechend aktuell gehalten (wenn man das möchte).

Auch hier geben wir dem Stack einen Namen.

Natürlich kann hier jede Art von git-Repository verwendet werden. GitHub ist nur das prominenteste Beispiel der Cloud Anbieter für git-Repositories.

Als Repository-URL gibst du den Standardpfad bzw. URL des Repos ein. Das ist meist die Startseite. Die „Repository reference“ kannst du leer lassen, denn diese nimmt immer die Dateien aus dem Master Branch. Wenn du das nicht möchtest, weißt du sicherlich selbst, was du hier einzutragen hast.

Der „Compose path“ ist im Standard nur eine einfach „docker-compose.yml“-Angabe. Ich habe für dieses Beispiel eine Anwendung aus meiner Sammlung genommen und muss entsprechend den Pfad dorthin genau angeben.

Auch hier müssen wir anschließend nur auf „Deploy the Stack“ unten klicken und schon wird die compose-Datei aus dem Repo geklont und die Anwendung deployt.

Fazit

Portainer erweist sich als unverzichtbares Tool für jeden, der mit Docker arbeitet, egal ob Anfänger oder erfahrener Profi. Durch seine benutzerfreundliche grafische Oberfläche wird die Verwaltung von Containern, Images und Netzwerken erheblich vereinfacht, ohne dabei auf Flexibilität und Funktionsvielfalt zu verzichten. Besonders vorteilhaft ist, dass Portainer nicht nur für kleinere Umgebungen, sondern auch in größeren, produktiven Setups problemlos einsetzbar ist. Es hilft, komplexe Docker-Architekturen übersichtlich zu strukturieren und bietet umfassende Verwaltungs- und Überwachungsmöglichkeiten, die weit über das hinausgehen, was die Kommandozeile bietet.

In diesem Tutorial haben wir die Grundlagen von Portainer beleuchtet – von der Installation über die wichtigsten Funktionen bis hin zu praktischen Anwendungsszenarien. Damit solltest du nun bestens gerüstet sein, Portainer in deinem eigenen Docker-Setup erfolgreich einzusetzen und deine Workflows effizienter zu gestalten.

Abschließend lässt sich sagen, dass Portainer nicht nur Zeit und Mühe spart, sondern auch dazu beiträgt, die Container-Verwaltung sicherer und kontrollierter zu gestalten. Wer Docker nutzt, sollte Portainer als Ergänzung auf jeden Fall in Betracht ziehen, um das Beste aus seiner Container-Umgebung herauszuholen.

Mit diesem Traefik letsencrypt Tutorial möchte ich dir helfen einfach und sauber Zertifikate via freier CA Let’s Encrypt zu beantragen und zu verwalten. In diesem Tutorial gehe ich auf die Punkte http-challenge, dns-challenge sowie weiteres Zertifikatsmanagement ein. Sollte Dir ein Punkt fehlen, schreibe mir dazu gerne in Kommentare.

Solltest Du auf dieses Tutorial gestoßen sein, weil du Docker nutzt, kann ich dir meinedocker-compose Sammlung auf GitHub (externer Link) sehr ans Herz legen. Dort sind gerade für das ThemaHomelab sehr viele Softwareprodukte hinterlegt die eine direkteTraefik (externer Link) Anbindung realisieren. Sicherlich ist auch meine Traefik Konfiguration ein guter Startpunkt für ein gutes Gelingen.

Traefik Grundkonfiguration

Traefik lässt sich über mehrere Wege konfigurieren. Hierbei spielt es keine Rolle ob man sämtliche Befehle und Konfigurationen direkt in die docker-compose Datei oder in separate Dateien packt. Ich für meinen Teil verwende dedizierte um eine einfachere und übersichtliche Konfiguration zu haben. Solltest du einen anderen Weg bevorzugen ist dies für dieses Traefikletsencrypt (externer Link) Tutorial nicht wichtig. Du musst natürlich nur die Einstellungen adaptieren.

Das ist ist meine Docker Compose Beispielkonfiguration welche ich normalerweise einsetze. Je nach Umgebung kann diese aber natürlich ein wenig variieren. Ich gebe auch immer http3 mit aus, einfach weil ich es mag neue Standard direkt mit zu implentieren.

---services:traefik:image:traefik:v3container_name:traefikvolumes:-/etc/localtime:/etc/localtime:ro-/etc/timezone:/etc/timezone:ro-/var/run/docker.sock:/var/run/docker.sock-/var/log/auth.log:/var/log/auth.log:ro-/var/log/traefik:/var/log/traefik-./config:/etc/traefiknetworks:-traefik_proxy-defaultports:-target:80published:80protocol:tcpmode:host-target:443published:443protocol:tcpmode:host-target:443published:443protocol:udpmode:hostrestart:unless-stoppednetworks:traefik_proxy:external:truedefault:driver:bridge

Anschließend brauchen wir natürlich noch die zwei Dateien die wir oben als Volume angegeben haben. Starten wir mit dertraefik.yaml Diese beinhaltet alle notwenigen Eigenschaften umTraefik sauber ans laufen zu bekommen.

---log:level:"INFO"filePath:"/var/log/traefik/traefik.log"accessLog:filePath:"/var/log/traefik/access.log"bufferingSize:100providers:docker:endpoint:"unix:///var/run/docker.sock"exposedByDefault:falsenetwork:"traefik_proxy"file:filename:"/etc/traefik/dynamic.yml"watch:trueapi:dashboard:falseentryPoints:ping:address:':88'web:address:':80'http:redirections:entryPoint:to:websecurescheme:httpswebsecure:address:':443'http3:proxyProtocol:trustedIPs:-10.0.0.0/8-172.16.0.0/12-192.168.0.0/16forwardedHeaders:trustedIPs:-10.0.0.0/8-172.16.0.0/12-192.168.0.0/16certificatesResolvers:default:acme:email:"deine@email-adresse.example"#Email Adresse hier anpassenstorage:"/etc/traefik/ACME/acme.json"httpChallenge:entryPoint:webtls_resolver:acme:email:"deine@email-adresse.example"#Email Adresse hier anpassenstorage:"/etc/traefik/ACME/acme.json"tlsChallenge:{}

Gehen wir die Punkt einmal durch:

[log]

Das Loglevel sollte für den produktiven Betrieb so gewählt werden, dass nach Möglichkeit nicht die Festplatte voll läuft. Für den Beginn ist es evtl. ratsam hier aufDEBUG umzustellen um mehr zu sehen und um Fehler leichter erkennen zu können.

[providers]

Wir nutzen für diese Beispielkonfiguration Docker. Wir möchten allerdings nicht, dass grundsätzlich alleDocker Container via Traefik veröffentlicht werden (exposedByDefault = false) und setzen die jeweiligen Anpassungen für jeden Container dediziert. Traefik lassen wir auf den Docker Socket hören um zu wissen was Traefik so machen muss. Gegebenenfalls musst du den Parameter „network“ anpassen. Ich nutze hierfür immer „traefik_proxy“ als Netzwerk. Möchtest du das ebenfalls nutzen musst du

docker network create traefik_proxy

ausführen und das Netzwerk anzulegen.

[api]

Das Dashboard brauchen wir hierfür nicht, wird also deaktiviert

[entryPoints]

Die entryPoints sind die Ports und Protokolle auf die Traefik hört. Stand jetzt kann Traefik nur HTTP/HTTPS Traffic. Weitere Protokolle sollen in Zukunft kommen. Wir lauschen natürlich auch auf Port 80 (HTTP) und machen eine direkte Weiterleitung auf Port 443 (HTTPS). Unverschlüsselte Kommunikation sollte nur in Ausnahmefällen noch erlaubt sein.

Wie du siehst binden wir auch eine dynamic.yml Datei ein. Diese hat folgenden Aufbau

---tls:options:default:minVersion:VersionTLS12cipherSuites:-TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256-TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384-TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305-TLS_AES_128_GCM_SHA256-TLS_AES_256_GCM_SHA384-TLS_CHACHA20_POLY1305_SHA256curvePreferences:-CurveP521-CurveP384sniStrict:truehttp:middlewares:default:chain:middlewares:-default-security-headers-gzipdefault-security-headers:headers:browserXssFilter:truecontentTypeNosniff:trueforceSTSHeader:trueframeDeny:truestsIncludeSubdomains:truestsPreload:truestsSeconds:31536000customFrameOptionsValue:"SAMEORIGIN"gzip:compress:{}

Die dynamic.yml ist zur Konfiguration aller Sicherheitsmerkmale gedacht. Bitte passe diese nach den aktuellen Gegebenheiten an, da sich gerade die Cipher Suites häufig ändern können! Die restlichen Werte sind nach langjähriger Erfahrung von mir so zusammen getragen und müssen nicht dem aktuellen Sicherheitsstandards entsprechend. Für Tipps bin ich aber dankbar und passe die Datei dann gerne an.

Traefik letsencrypt tlsChallenge

Mit der tlsChallange ist es wahrscheinlich die einfachste Variante Zertifikate via Let’s encrypt zu beantragen. Hier kann Traefik direkt so konfiguriert, bzw. über die Docker Konfiguration so eingerichtet werden, dass nur Port 443, also HTTPS, veröffentlicht werden muss. Möchte man nur ein paar wenige Zertifikate beantragen ist das meiner Meinung die empfehlenswerte Version.

Die Konfiguration der tlsChallenge ist ziemlich einfach. Man fügt in der traefik.toml Datei folgende Zeilen am Ende ein:

certificatesResolvers:default:acme:email:"deine@email-adresse.example"#Email Adresse hier anpassenstorage:"/etc/traefik/ACME/acme.json"

Email-Adresse ist für die Benachrichtigung von Let’s encrypt an dich gedacht. Entsprechend empfehle ich hier eine valide Email-Adresse anzugeben. Die Storage Angabe ist der Speicherort der Zertifikate. Entsprechend muss in der Docker Konfiguration auch das beachtet werden.

Traefik letsencrypt httpChallenge

Die httpChallenge ist quasi das gleich wie die tlsChallenge, allerdings via Port 80 anstatt 443. Hier muss als in der Docker Konfiguration auch Port 80 veröffentlicht werden. So ergibt sich daraus folgender Inhalt für die traefik.toml:

certificatesResolvers:default:acme:email:"deine@email-adresse.example"#Email Adresse hier anpassenstorage:"/etc/traefik/ACME/acme.json"httpChallenge:entryPoint:web

Traefik letsencrypt dnsChallenge (am Beispiel Cloudflare)

Die dnsChallenge ist quasi die Königsdisziplin. Allerdings nur wirklich dann sinnvoll wenn man z. B. Wildcard Zertifikate benötig oder wenn man viele Subdomainzertifikate benötigt. Entsprechend muss man hier auch ein wenig mehr konfigurieren und vor allen Dingen benötigt man einen DNS Provider der von Let’s encrypt unterstützt wird. Ich empfehle hier Cloudflare.

certificatesResolvers:default:acme:email:"mail@teqqy.de"storage:"/etc/traefik/ACME/acme.json"dnsChallenge:provider:"cloudflare"resolvers:-"1.1.1.1:53"-"1.0.0.1:53"

Hinzu kommt, dass wir in derdocker-compose.yaml noch den API Token für die Cloudflare API hinzufügen. Dazu einfach noch folgende Zeilen einfügen:

environment:CF_DNS_API_TOKEN:"{STRENGGEHEIMERAPIKEY}"

Zertifikate löschen

Zertifikate werden in deracme.json Datei gespeichert und könnten dort heraus gelöscht werden. Zu jedem Zertifikat gibt es einecertificate undkey Definition. Man kann also die Datei entsprechend editieren und die Zeichenketten entsprechend heraus löschen.

 {"domain": {"main":"teqqy.de","sans": ["www.teqqy.de" ] },"certificate":"<Zeichenkette>","key":"<Zeichenkette>","Store":"default" },

Notwendig ist dies aber nur dann, wenn bei der Erstellung ein Fehler aufgetreten ist oder Let’s Encrypt Zertifikate wg. Fehlern zurückruft. Andernfalls laufen die Zertifikate automatisch nach 90 Tagen ab. Ein manuelles Aufräumen ist nicht notwendig.

Viele Menschen starten ihr Homelab mit ein oder zwei Programmen auf einem kleinen Rechner. Langsam aber sicher wird dieses dann ausgebaut und im Laufe der Zeit erweitert. Geht man weg von einemRaspberry Pi (externer Link) und wechselt zum Beispiel auf einen Intel NUC hat man viel Freiraum für neue Services.

Genau aus diesem Grund möchte ich dir als Anregung meine Top 10 Homelab Services aufzählen. Vielleicht ist ja noch ein wenig Inspiration für dich mit dabei.

Bevor du dein Homelab startest solltest du dir erst einmal Gedanken machen auf welcher Hardware du deine Dienste installieren möchtest. Am einfachsten startet man mit alter, vorhandener Hardware. Solltest du etwas stromspurenderes benötigten kann man mit einemRaspberry Pi (externer Link) starten. Auf Amazon gibt es diverse Sets die direkt alles in einem liefern. Das ist zwar etwas teurer, dafür musst du dich nicht um Einzelteile kümmern.

Eine Alternative die natürlich mehr Power haben, sind Intel NUCs. Diese sehr beliebten Minirechner sind von kleinen stromsparenden CPUs bis hin zu einem potenten Core i7! Wer direkt viel Freiraum haben, langfristig plant und dennoch wenig für Strom ausgaben möchte ist damit wohl am besten bedient.

Meine Top 10 Homelab Services

Natürlich sind diese Softwareprodukte in eine Reihenfolge gebracht worden. Allerdings ist es manchmal schwer diese auch dauerhaft so zu verargumentieren. Die Reihenfolge ändert sich natürlich immer ein wenig. Aber die Produkte an sich bleiben doch meist gleich. Also los gehts:

10 – FreshRSS

FreshRSS (externer Link) ist wie der Name schon verrät ein RSS Reader. Eigentlich ja nichts Besonderes zumal es ja viele Cloud-Dienste wie z. B. Feedly gibt, die genau das gleiche machen. Wir wären aber nicht im Homelab, wenn wir nicht versuchen würden, möglichst viele Dienste selbst bereitzustellen.

Mit FreshRSS kannst du über den Browser den RSS Feed deiner Lieblingsblogs und -webseiten lesen. Hoffentlich auch den von teqqy.de 😉

Ich nutze als mobilen Client unter iOS zudem nochReeder (externer Link) . Diese App hat eine direkte Integration für FreshRSS und macht so das Setup total einfach.

Paperless-NG (externer Link) ist ein DMS (Document Management System) und der Nachfolger des leider nicht mehr weiter entwickelten paperless. Viele Tutorials da draußen funktionieren auch weiterhin mit paperless-ng. Ein DMS hilft dir deinen Papierkram digital zu strukturieren und im Falle des Falles schnell wieder zu finden.

Im Laufe der Zeit habe ich verschiedene andere DMS Systeme ausprobiert. Das ebenfalls kostenfreie papermerge sowie das kostenpflichtige ecoDMS, um nur zwei der gefühlt unendlich langen Liste zu nennen.

8 – Hajimari

Davon wirst du bestimmt noch nichts gehört haben. Macht nichts, dafür bin ich ja da. Hajimari ist einDashboard . Aber im Gegensatz zu Dashboards wie Heimdall ist dies rein auf die Installation in einem Kubernetes Cluster spezialisiert. Hajimari verwendet die Ingress API, um automatisch die Anwendungen im Cluster darzustellen.

Zudem kann es noch mit weiteren Links zu Lieblingsseiten erweitert werden. Falls du kein Kubernetes einsetzt, empfehle ich dir Heimdall oder Organizr mal anzugucken. Zu beiden gibt es sogar auch ein Video auf meinemYouTube (externer Link) Kanal.

7 – Littlelink

Sicherlich auch ein Service von dem du noch nichts gehört hast.Littlelink (externer Link) ist eine Alternative zu Linktree, einer Onlineplattform um Links zu verschiedenen Webseiten zusammen zu fassen. Wenn du viel in sozialen Netzwerken unterwegs bist, hast du das sicherlich schon mal gesehen.

Littlelink wurde von dem YouTuber TechnoTim (Folgeempfehlung (externer Link) ) erstellt und kann natürlich auch via Docker installiert werden. Ein Beispiel kannst du dir beimir (externer Link) anschauen.

6 – Grafana

Im Laufe der Zeit sammeln sich verschiedene Metriken, Performance- und Statistikdaten im Homelab an. Sei es durch das Monitoring, die Heim-Automatisation oder einfach nur weil die intelligenten Steckdosen den Strom sauber messen sollen. Grafana ist hierbei eines der, wenn nicht das beste Tool, um diese Daten zu visualisieren. Einen guten Einsteig in Grafana habe auch als kleineTutorialserie (externer Link) auf YouTube veröffentlicht. Vielleicht ist das ja noch was für dich.

5 – Authentik

Bereits vor kurzem hatte ich einen Blogartikel veröffentlicht, wie man Proxmox an Authentik anbinden kann. Aber was ist Authentik eigentlich? Mit dieser Software kannst du eine zentrale Nutzerverwaltung für deine Homelab Dienste bereitstellen. So musst du nicht in jeder Anwendung einzelne Benutzeraccounts pflegen.

Das besondere an Authentik ist, dass es die Benutzer auch nicht selbst pflegen muss, sondern z. B. von GitHub, Google oder LDAP heranziehen kann. Dir stehen damit also viele Möglichkeiten offen.

Ich versuche mittlerweile, jede Software, die eine Schnittstelle zu OpenID, oAuth oder LDAP hat, mit Authentik bekannt zu machen, um mir die Pflege der Nutzeraccounts zu vereinfachen.

4 – Proxmox

Proxmox? Ja Proxmox. Eine gute Virtualisierungsplattform zu haben, ist für das Homelab äußerst praktisch. Es lassen sich schnell und einfach neue System hoch ziehen und neue Software und Tools ausprobieren. Die Möglichkeit neue Dinge zu lernen kann somit schier unendlich sein.

{% youtube Io7oOnmhpZs %}

3 – Jellyfin

Ich ware viele Jahre Plex Nutzer. Plex ist ein Netzwerkmediaplayer, um Filme, Serien oder Musik im Netzwerk zu streamen. Da die coolen Funktionen in Plex nur mit einem Plex Pass zu haben sind, welcher gebührenpflichtig ist, ist das für viele ein kleines Hindernis.

Weitere Platzhirsche sind noch Kodi und Emby. Kodi hat für mich persönlich den Nachteil, dass die ganze Intelligenz in Client am TV hängt, heißt der muss entsprechend die Power haben. Bei den anderen wird mögliche Transcodierleistung vom Server erwartet.

ZuJellyfin (externer Link) bin ich vor kurzem gewechselt, weil ich etwas neues ausprobieren wollte – und bin dort hängen geblieben. Es ist einfach eine richtig gute Software.

2 – blocky

Von dieser Software hast du sicherlich auch noch nichts gehört. PiHole oder AdGuard Home allerdings schon.Blocky (externer Link) ist eine weitere Alternative dazu. Ich setze eben diese ein, weil sie perfekt für einen Kubernetes Cluster gemacht ist: Leichtgewichtig, komplett via deployment zu konfigurieren und stabil.

Wer den Werbeblocker nicht in einem Containercluster bereit stellt, dem ist weiterhin aus meiner Sicht eher AdGuard als PiHole zu empfehlen. Ich verfolge zwar die Entwicklung von PiHole nicht mehr aktiv, war aber mit AdGuard einfach immer zufriedener.

1 – Home-Assistant

Sicherlich eine der wenigen Software in der Liste, die du auf jeden Fall kennst. Home-Assistant ist meine Software, um meine komplette Heimautomatisation zu steuern. Von smarten Glühbirnen über Tür- und Fenstersensoren, Luftbefeuchter bis hin zu Staubsaugern und vielem mehr wird hierüber durch verschiedene Automatisierungen gesteuert. Meine Konfiguration findet du dazu übrigens auch aufGitHub (externer Link) .

Home-Assistant nutze ich, seit dem ich vor ca. 4 Jahren von FHEM dorthin gewechselt bin. Mit FHEM wurde ich irgendwie nie wirklich warm und openHAB2… nunja… Es ist Java…

Sonstiges

Sicherlich vermisst du Dienste wie Passwortmanager oder Codeverwaltung? Das liegt daran, dass beide Services so wichtig sind, dass ich im Homelab nicht die notwendige Uptime dafür bereitstellen kann und möchte. Zwar gehört auch immer ein gewisses Stück Vertrauen in die Software, allerdings haben mich 1Password als Passwortmanager und GitHub als Codeverwaltung noch nie enttäuscht.

Zwischenzeitlich hatte ich beide Services sogar mal selbst gehostet, aber auf Grund der eben angesprochenen Problematik dann doch wieder einem Cloud-Service überlassen.

In allen meiner Tutorials verwende ich Traefik alsReverse Proxy für Docker Container, so natürlich auch auf meinemYouTube Kanal (externer Link) . Im Laufe der Zeit fragen immer wieder Leser und Zuschauer ob ich ihnen bei ihrem Problem helfen kann. Dies mache ich natürlich gerne. Für ein gewisse Selbsthilfe möchte ich dir allerdings diesen Traefik Troubleshooting Guide an die Hand geben.

Vorbereitende Maßnahmen

Um mit einem guten Troubeshooting zu beginnen möchte ich zwei Maßnahmen vorweg greifen. Diese helfen dir ein paar Dinge auszuschließen bzw. eventuell schnell selbst auf eine Lösung zu kommen.

Container richtig neu starten

Wenn ihr Änderungen am Container von Traefik oder gar an den Konfigurationsdateien vornimmt, muss Traefik komplett neu gestartet werden. Ein stoppen des jeweiligen ist nicht ausreichend. Beimeinen Compose Dateien (externer Link) verwende also bitte nach dem stoppen noch ein

docker-compose rm

um diesen komplett zu löschen. Anschließend kannst du den Container wieder starten und eine neue Konfiguration ist übernommen.

Erhöhen des Log Levels

Zum Traefik Troubleshooting gehört auf jeden Fall auch das betrachten der Log Dateien. In meiner Vorlage steht das Logging auf einer sehr kleinen Stufe um nicht unnötig Speicherplatz zu benötigen. Wenn du mit Traefik startest empfehle ich dir, dieses auf debug zu stellen.

Hierzu einfach die traefik.toml Datei anpassen:

[log]
level = "DEBUG"

Fehlerlösungen

Die Webseite wird als nicht sicher angezeigt

Dieser Fehler entsteht zumeist wenn Traefik keinLet’s Encrypt (externer Link) Zertifikat abrufen konnte. Leider kann das mehrere Ursachen haben:

Zu häufiges Abrufen von Zertifikaten

Im Log steht hier meist, dass die Anzahl der Möglichen Erstellversuche von Zertifikaten erreicht ist. LE lässt es nur zu 10 Versuche binnen 24 Stunden auf ein SSL-Zertifikat zu erstellen. Wenn du eine eigene Domain hast, versuche es mit einer anderen Subdomain erneut. Andernfalls hilft nur warten.

Ein anderer Container hört auf Port 80

Let’s Encrypt nutzt bei der ersten Kommunikation zwischen Server und Client auch HTTP (Port 80). Wenn dieser Port also noch durch einen anderen Container geblockt ist kann keine Verbindung aufgebaut werden. Ebenso könnte es sein, dass dein NAT in deinem Router Port 80 noch nicht weiter leitet.

Eine 404-Seite wird angezeigt

Jetzt wird es spannend. Sobald eine 404-Seite angezeigt wird, gibts nämlich ein Problem mit dem Routing zu den Containern. Folgende Dinge kannst du hier prüfen:

• Wird der korrekte Port weiter geleitet?
• Stimmen alle Middlewere-Configs überein?

WordPress ist eine der beliebtesten CMS Systeme. Leider ist die Geschwindigkeit häufig nicht gut. Mit meinen drei Tipps kannst du die WordPress Docker Performance ein gutes Stück verbessern.

Im Internet gibt es nicht wirklich viele Informationen zu dem Problem. Meist wird behauptet, dass es am Hostsystem liegen soll. Da ich das bereits ausschließen konnte wurden viele Beiträge obsolet.

Anfangen sollte man aller erstes aber mit der Messung von harten Zahlen. Eine subjektive Meinung hilft bei der Geschwindigkeit meist wenig. Ob eine Seite schnell oder langsam lädt ist auch ein Rankingfaktor bei Google, also wichtig für das SEO.

Ich überprüfe die Geschwindigkeit häufig mitGoogle PageSpeed Insights (externer Link) . Es gibt zwar noch viele weitere Tools um die Ladezeiten einer Webseite zu messen, aber ich habe mich sehr an das Tool gewöhnt. Schlussendlich bleibt es aber dir überlassen, welches du nimmst. Wichtig ist nur, dass du vorher und nachher das die gleiche Software verwendest und damit nicht Äpfel mit Birnen vergleichst.

In den Tiefen Wurzeln von Google (quasi ab Seite 4) entdeckte ich dann einen Beitrag der darauf hin wies, dass die Verwendung von bind mounts unterDocker häufig zu Performance Problemen führen kann. Gerade bei Webseiten soll, so die Informationen, immer nur eine Datei gleichzeitig geöffnet werden. Das beeinträchtigit die WordPress Docker Performance dann sehr.

Ich wollte diesen Blog also nicht direkt umstellen, sondern testete erst einmal mit einer neuen Installation und siehe da: Es rannte!

Entsprechend habe ich in meinerdocker-compose.yaml (externer Link) Datei ein zweites Volume hinzugefügt und den Stack neu gestartet. Anschließend über die CLI unter Linux die Dateien vom bind mount in das Volume kopiert.

Docker bietet zwar mitdocker cp ein eigenen CLI Befehl, allerdings wollte ich das direkt am Linux System machen. Ob das gut ist, wird sich noch raus stellen.

Mittels

cp -R{bind mount pfad}/* /var/lib/docker/volumes/{volume id}/_data/wp-content/chown www-data. -R /var/lib/docker/volumes/{volume id}/_data/

die Daten kopiert und die Rechte angepasst. Nach Neustart des Stacks merke man schon einen deutlichen Performanceboost.

WordPress Docker Performance mit Redis verbessern

Anschließend habe ich direkt noch Redis als Cache hinzugefügt. Mit demPlugin Redis Object Cache (externer Link) wird das dann unter WordPress aktiviert. In meiner Compose Datei habe ich natürlich erst noch den Redis Container hinzugefügt:

wordpress-cache:image:redis:latestcontainer_name:teqqyde-cacherestart:unless-stoppeddepends_on:-wordpress-appnetworks:-default

Unter Docker findet das Plugin den Redis Server nicht. Also muss noch die wp-config.php Datei angepasst werden

vim /var/lib/docker/volumes/{volume id}/_data/wp-config.php

Dort fügen wir unter den ganzen anderen „define“ Variablen noch die Zeile

define( 'WP_REDIS_HOST', 'wordpress-cache');

hinzu. Nun wieder den Stack komplett neu starten und das Plugin aktivieren. Nach kurzer Zeit gibt es auch bereits die ersten Informationen in den Metriken.

Sicherlich gibt es noch weitere Punkte um die WordPress Docker Performance zu verbessern, allerdings reicht mir diese erst einmal aus.

WordPress Docker Performance messen

Um nun zu überprüfen ob die Performance gestiegen ist, können wir erneut mit dem Google Page Speed Insights die Webseite messen. In meinem Fall bin ich in fast allen Punkten in kleines Stück besser geworden. Natürlich benötigt man noch weitere Optimierungen, aber für den Anfang ist schon vieles gemacht.

]]>selfhostedwordpressdockerhttps://www.teqqy.de/docker-befehle-fuer-den-alltag/Sun, 20 Sep 2020 13:23:41 +0200Sun, 20 Sep 2020 13:23:41 +0200https://www.teqqy.de/docker-befehle-fuer-den-alltag/Um Docker im Alltag zu meisten, ist es ratsam sich ein paar Docker Befehle anzueignen und diese anwenden zu können. Ich möchte dir ein paar meiner alltäglichen Helfer in diesem Beitrag vorstellen. Docker (externer Link) hat sich in den letzten Jahren immer mehr entwickelt und ist aus vielen Homelabs nicht mehr weg zu denken. Einige recht umfangreiche Infrastrukturen basieren vollständig auf dieser Art der Containerisierung. Im Laufe der Zeit wird man immer mehr zum Profi und kann auch komplexe Probleme schnell löschen. Als Anfänger allerdings steht man häufig vor Problemen.<![CDATA[

Um Docker im Alltag zu meisten, ist es ratsam sich ein paar Docker Befehle anzueignen und diese anwenden zu können. Ich möchte dir ein paar meiner alltäglichen Helfer in diesem Beitrag vorstellen.

Docker (externer Link) hat sich in den letzten Jahren immer mehr entwickelt und ist aus vielen Homelabs nicht mehr weg zu denken. Einige recht umfangreicheInfrastrukturen basieren vollständig auf dieser Art der Containerisierung. Im Laufe der Zeit wird man immer mehr zum Profi und kann auch komplexe Probleme schnell löschen. Als Anfänger allerdings steht man häufig vor Problemen.

Informationen über Docker Container

Wir starten mit einem Docker Befehl um die Informationen eines Containers, heißt IP-Adresse, Konfiguration und ähnliche Dinge einsehen zu können.

docker inspect {container name}

Log des Containers einsehen

Sollten alle Container immer problemlos laufen, bräuchten wir diesen Beitrag nicht. Aber wir wissen alle, dass das nicht der Fall ist. Um sich die Log Dateien bzw. das STDOUT des Containers anzuschauen gibt es den Befehl

docker logs {container name}

Dieser listet alle Loginformationen seit dem letzten Start des Containers auf. Dies kann also schon mal recht lang werden. Einfacher ist es dann den Befehl um ein -f zu erweitern

docker logs -f {container name}

Jetzt haben wir die Chance das Logfile dauerhaft anschauen zu können. Sobald der Container also etwas protokolliert, wird dies direkt angezeigt. Mit STRG+C können wir das abbrechen.

Alle Container stoppen

Manchmal muss man alle Container auf einmal beenden. Zum Beispiel wenn man Update am Hostsystem einspielen, das Hostsystem kontrolliert herunterfahren oder andere Wartungsarbeiten durchführen möchte.

Wer mitDocker Compose arbeitet und nur eine große Datei hat – davon sei übrigens abzuraten – hat es einfach. Allerdings ist das nur sehr selten der Fall.

docker stop $(docker ps -a -q)

Der Befehl stoppt alle Container (docker stop) die mit dem Befehl (docker -ps -a -q) gefunden werden. Also alle Container, egal welchen Status diese derzeit haben. Hier werden also Docker Befehle zusammen gefasst um dir das Leben direkt zu erleichtern.

Alle Container löschen

Ab und zu ist es auch notwendig alleDocker Container zu löschen. Zum Beispiel um neue Environment-Variablen einzulesen. Allerdings müssen wir erst alle Container stoppen, z. B. mit dem Befehl weiter oben.

Anschließend bedienen wir uns einer sehr ähnlichen Technik und löschen alle Container die mit docker ps gefunden werden

docker rm $(docker ps -a -q)

Ich hoffe ich konnte dir ein paar nützliche Docker Befehle mit an die Hand geben. Mich würde es noch interessieren, was deine Empfehlung für diese Liste wäre.

Vor einiger Zeit gab es von mir ein Nextcloud Docker Setup Tutorial bereits auf meinemYouTube Kanal. (externer Link) Dies ist soweit auch weiterhin aktuell. Allerdings bedarf es für eine gute Nextcloud Installation noch weiterer Konfiguration.

Um Nextcloud immer von überall aus erreichen zu können, empfehle ich dir die Installation auf einem virtuellen Server bei einem Hosting Provider. Ich nutze hierfür Netcup, welche ich sehr empfehlen kann.

Nextcloud Docker Setup als Video

Mit diesem Video hast du das Basissetup von Nextcloud. Jetzt werden wir das ganz noch etwas besser einrichten und vor allen Dingen die Warnungen aus dem Administrationsbereich beseitigen.

Wenn du Nextcloud nicht in deinem Homelab selbst hosten möchtest, empfehle ich dir Netcup als Hostingunternehmen. Meine langjährige Erfahrung mit Netcup hat mit gelehrt das ein zuverlässiger Partner im Bereich Hosting Gold wert ist. Auch wenn das manchmal ein paar Euro im Jahr mehr kostet.

Aktuelle Compose Datei verwenden

MeineDocker Compose Dateien (externer Link) ändern sich zwischendurch. Beachte also bitte, dass du die aktuellen Dateien verwendest. Dieses Tutorial ist fürTraefik als reverse proxy ausgelegt. Solltest du etwas anderes nutzen wollen, musst du dir diverse Einstellungen herleiten. Gerade auch die Traefik Konfiguration ändert sich, gerade was die Sicherheitseinstellungen angeht, auch. Bitte updatete daher gegebenenfalls auch diese.

Installation durchführen

Nun kannst du die Installation, wie im Video beschrieben, durchführen. Ich gehe entsprechend davon aus, dass du jetzt eine funktionsfähige Installation hast.

Reverse Proxy Konfiguration

Nextcloud möchte, dass wir die notwendigen Einstellungen vornehmen um der Installation die reverse proxy Konfiguration mitzugeben. Als erstes benötigen wir die IP Adresse inCIDR (externer Link) Notation unseres Traefik Containers

~~bash docker inspect traefik

Nun rattern ein paar Zeilen config durchs Bild. Interessant ist für uns eigentlich nur der letzte Abschnitt:

 "traefik_proxy": {
"IPAMConfig": null,
"Links": null,
"Aliases": [
"0d9ab883d62e",
"traefik"
],
"NetworkID": "b23ae2baa87df4b02c1cbed4679c8ea3c4ef4d2b8c8d05efb4b0bf0d94ced7f2",
"EndpointID": "44b9f2e00a25177f6084ecfa270df6be9cc75430ed64609ce60897fda8ca67b6",
"Gateway": "172.19.0.1",
"IPAddress": "172.19.0.4",
"IPPrefixLen": 16,
"IPv6Gateway": "",
"GlobalIPv6Address": "",
"GlobalIPv6PrefixLen": 0,
"MacAddress": "02:42:ac:13:00:04",
"DriverOpts": null
}

Diese Informationen sind häufig unterschiedlich. Du solltest also meine Werte nicht einfach blind übernehmen. Aus dem obrigen Teil benötigen wir die Punkte „IPAddress“ und „IPPrefixLen“.
Damit editieren wir nun die config.php Datei unserer Nextcloud Installation und passen diese im Bereich „trused\_proxies“ an. Die Angabe setzt sich also aus IP-Adresse mit anschließender Netzgröße zusammen.

’trusted_proxies’ => ‘172.19.0.4/16’

### Datenbank Optimierungen durchführen
Die Übersichtsseite möchte das wir noch ein paar Änderungen in der Datenbank durchführen. Dieses machen wir, indem wir uns mit einem „docker exec“ Befehl kurz in den Container verbinden und den notwendigen Befehl der Nextcloud CLI durchführen. Beide Befehle solltest du nach Möglichkeit vor weiterer Einrichtung und Benutzung von Nextcloud durchführen. Andernfalls können diese Befehle einige Zeit in Anspruch nehmen.
~~~bash
docker exec --user www-data nextcloud-app php occ db:add-missing-indicesdocker exec --user www-data nextcloud-app php occ db:convert-filecache-bigint

Beide Befehle brauchen jeweils einen kurzen Moment. Je nach Leistung deines Servers.

Nextcloud Client Einstellungen anpassen

Damit wir den Nextcloud Client benutzen können, musste ich noch ein paar weitere Einstellungen an der config.php durchführen. Ändere die Option „overwrite.cli.uri“ ab und füge noch zwei Zeilen hinzu:

 'overwrite.cli.url' => 'https://nextcloud.example.com', 'overwriteprotocol' => 'https', 'overwritehost' => 'nextcloud.example.com',

Natürlich musst du die jeweiligen URLs an deine Installation anpassen.

Container sauber neu starten

Damit dieses Nextcloud Docker Tutorial auch wirklich funktioniert müssen wir anschließend unsere Container komplett neu starten. Erst einmal beenden wir alles

docker compose stop

und anschließend löschen wir die Container, damit die Konfiguration auch wirklich übernommen wird

docker compose rm -f

Jetzt sind wir bereit die Instanz frisch zu starten

docker compose up -d

Unter Einstellungen -> Überblick sollten also keine weiteren Meldungen mehr auftauchen.

Nun sollte dein Nextcloud Docker Setup hervorragend laufen. Sollte dem nicht so sein, tritt doch meinemDiscord Server (externer Link) bei und lass dir von der Community helfen.

Traefik nutze ich primär um als reverse proxy von extern auf meine Docker Container zugreifen zu können. Dies natürlichSSL terminiert. Verschiedene Dienste sollen allerdings nicht extern erreichbar sein und benötigen auch – aus meiner Sicht – nicht zwingend eine verschlüsstele Verbindung.

Aus diesem Grund habe ich auf meinem internen Docker ServerTraefik als reverse proxy laufen, welcher den verschiedenen Diensten via netzwerkinterner DNS-Auflösung ein DNS Namen verpasst. So kann ich z. B. viahttp://phpipam.docker.domain.local (externer Link) auf meinPHPIPAM (externer Link) Dienst zugreifen.

Voraussetzungen

• Docker Host
• Bereits eingerichtet Services (ich empfehle die Services intern immer erst mal rudimentär zu testen und dann zu erweitern)
• internen DNS Server (ich nutze hier Windows DNS)

Auf meinem Windows DNS Server lege ich im DNS eine neue primäre Zone mit dem Namen „docker.domain.local“ (entsprechend an deine Bedürfnisse anpassen). Diese erhält dann einen einzigen A-Record der als Wildcard auf den Docker-Host zeigt.

Traefik einrichten

Um Traefik dann nutzen zu können, bediene ich mich zum Teil meiner vorhandenenDocker-Compose Sammlung (externer Link) aufGithub (externer Link) . Den Traefik Container und die traefik.toml Datei wird dabei ein wenig angepasst.

traefik.toml:

[log]level ="DEBUG"[providers][providers.docker]exposedByDefault =falseendpoint ="unix:///var/run/docker.sock"network ="traefik_proxy"[entryPoints][entryPoints.web]address =":80"

docker-compose.yaml

---version:'3.3'services:traefik:image:traefik:latestcontainer_name:traefikrestart:alwaysvolumes:-/var/run/docker.sock:/var/run/docker.sock-$PWD/config:/etc/traefik-/etc/localtime:/etc/localtimeports:-"80:80"networks:-default-traefik_proxynetworks:traefik_proxy:external:truedefault:driver:bridge

Anschließend lässt sich der Container starten und ist bereit um Container als reverse proxy anzubieten.

Bei den anzubietenden Services müssen wir dann natürlich auch noch die Compose Datei anpassen. Beispielhaft hier meine zu phpIPAM:

---version:'3'services:phpipam-mysql:image:mysql:5.7container_name:phpipam-mysqlrestart:unless-stoppedvolumes:-$PWD/mysql:/var/lib/mysqlenvironment:-MYSQL_ROOT_PASSWORD=ROOTPASSWORDphpipam-phpipam:image:pierrecdn/phpipam:latestcontainer_name:phpipam-phpipamrestart:unless-stoppedenvironment:-MYSQL_ENV_MYSQL_USER=root-MYSQL_ENV_MYSQL_ROOT_PASSWORD=ROOTPASSWORD-MYSQL_ENV_MYSQL_HOST=phpipam-mysqllabels:-"traefik.enable=true"-"traefik.http.routers.phpipam-http.entrypoints=web"-"traefik.http.routers.phpipam-http.rule=Host(`phpipam.docker.domain.local`)"#Domain anpassen-"traefik.http.services.phpipam.loadbalancer.server.port=80"depends_on:-phpipam-mysqlnetworks:-traefik_proxy-defaultnetworks:traefik_proxy:external:truedefault:driver:bridge

Anschließend auch noch diese Compose Datei starten und nun lässt sich, wenn alles korrekt eingerichtet wurde, der Service als URL öffnen. So ist es wesentlich einfacherer als ich für jeden Service einen neuen Port überlegen zu müssen.

Um das Docker Monitoring sollte man sich nicht drücken, denn es ist wichtig zu sehen, welche Auslastung die einzelnen Container verursachen. Zum einen um etwaige Probleme festzustellen und zum anderen um die Leistung des Docker Hosts evtl. anpassen zu können.

In meinemdocker-homelab (externer Link) Repository aufGithub (externer Link) habe ich vor kurzem ein Docker Compose Stack hinzugefügt, welche genau dies macht. Über die Monitoring ToolsPrometheus (externer Link) ,Node Exporter (externer Link) undcAdvisor (externer Link) werden die Daten erfasst und mittelsGrafana (externer Link) ansprechend dargestellt.

Docker Monitoring einrichten

Um das ganze wie im oben gezeigten Dashboard zu realisieren kann man sich meinerdocker-compose.yaml (externer Link) Datei bedienen. Am einfachsten ist es natürlich man verwendet das komplette Repository, weil dort auch alle anderen Dateien für das Docker Monitoring vorhanden sind.

Grundsätzlich reicht es dann mit einem einfachen

docker-compose up -d

den kompletten Monitoring Stack zu starten. Solltest du keinTraefik als Reverse Proxy nutzen kannst du in der docker-compose.yaml Datei auch den Bereich der Labels sowie die Netzwerkdefinition weg lassen.

Anschließend verbindet man sich über den gewünschten Browser mit dem Grafana Dashboard und loggt sich mitadmin/admin dort ein.

Im ersten Schritt muss man nun die Datenquelle hinzufügen. Im Dashboard bedarf es hier nur ein klick. Als Datenquelle verwenden wir entsprechend Prometheus.

Es müssen dann nur die Felder Name und URL gefüllt werden. Sollte das vordefinierte Dashboard aus dem Repository verwendet werden, sollte die Datenquelle den Namen „Prometheus“ tragen. Als URL wirdhttp://mon_prometheus:9090

eingetragen. Es sollte bei dir dann analog zu diesem Screenshot aussehen:

Sobald man aufSave & Test geklickt hat, sollte ein grüner Balken erscheinen der die erfolgreiche Verbindung bestätigt.

Grafana Dashboard importieren

Nun müssen wir nur noch das Grafana Dashboard importieren um das Docker Monitoring zu vervollständigen.

Hierfür klickt man links aufDashboard und anschließend aufmanage.

Über den Button importieren kann man nun diedashboard.json (externer Link) Datei hinzufügen. Es muss dann nur noch die korrekte Datenquelle angegeben werden und schon sollte das Dashboard entsprechend Werte anzeigen.

In meinen Videos verwende ich recht häufig Docker um Anwendungen zu installieren. Daher habe ich eine Docker-Compose Sammlung für Homelabs gestartet. Diese docker-compose.yaml Dateien sind von mir erstellt und/oder vorhandene editiert. Damit kannst du dein Docker Homelab schnell und einfach aufbauen.

Docker kommt beim heimischen Anwender immer mehr an. Zumindest wenn dieser technikinteressiert ist und sich auch die Arbeit damit machen möchte. Wer ein Docker Homelab starten möchte, kommt an Anfang nicht darum herum viel zu lesen. Allerdings möchte ich diesen Einstieg etwas einfacher gestalten.

Zwar gibt es immer noch das eine oder andere Problem mit dem reverse proxy (ich setze hierbei aufTraefik ), dennoch ist es mit ein paar Schritten schnell erledigt seine Lieblingsanwendung schnell und gut Verfügbar zu machen.

Auf der Plattformgithub.com (externer Link) habe ich daher einRepository (externer Link) erstellt das ständig erweitert und aktualisiert wird. Gestartet habe ich jetzt erst mal mit Nextcloud undTaefik . Hierzu wurde bereits ein Video veröffentlicht in dem ich das en detail zeige wie ihr das einrichten müsst.

Mit zukünftigen Videos wird auf dieses Repository immer hingewiesen und ich werde immer diese docker-compose.yaml Dateien verwenden. Wer mir also aufYouTube (externer Link) folgt (das solltest du, wenn du am Thema Homelab interessiert bist), wird die neusten Dateien immer mitbekommen.

Eines sei dazu aber noch gesagt: Diese Dateien sind sehr vereinfacht. Viele Dinge lassen sich anders und teils mit mehr Aufwand auch erledigen. Ich habe hier allerdings den kleinsten gemeinsamen Nenner gesucht und wohl auch gefunden. Solltet ihr Fehler entdecken, eröffnet einIssue (externer Link) beiGithub (externer Link) (wenn ihr einen Account habt) oder postet gerade in den entsprechenden Kommentaren.

Wenn dir eine bestimmte Software fehlen sollte, die du unbedingt dabei haben möchtest, bin ich natürlich gerne für Vorschläge offen. Natürlich kannst du auch ein Pull Request beiGitHub (externer Link) einreichen. Nach einer kurzen Überprüfung übernehme ich im Regelfall auch die Vorschläge der Community. So kann das Docker Homelab stetig bei allen wachsen.

Um mehrere Webseiten unter einer IP und einer Domain zu veröffentlichen, ist es am einfachsten, wenn man sich ein sogenannten reverse proxy einrichtet. Die wohl bekannte Variante dazu ist von NGINX. Hierfür gibt es auch diverse Tutorials im Internet.

Meine ganzen Services, die ich extern verfügbar machen möchte, laufen allerdings alsDocker (externer Link) Container. Entsprechend bietet es sich an, auch den reverse proxy Traefik unter Docker als Container laufen zu lassen.

Auch hier gibt es für NGINX – auch in Kombination mit Let’s encrypt Zertifikaten – reichlich Tutorials. Ich hatte mich damals allerdings für einen anderen Weg entscheiden undTraefik (externer Link) als reverse proxy genommen.

Wichtig ist natürlich, dass ihr in eurer Firewall bzw. Router ein NAT auf euren Docker Host einstellt. Port 80 (HTTP) und 443 (HTTPS) sollten entsprechend reichen.

Docker Container mittels Compose

Ich gehe erst mal davon aus, dass ihr Docker in einer der letzten Versionen installiert habt und eure Services, zumindest intern, vollständig funktionieren. Zudem nutze ich Docker Compose zum Verwalten meiner Container. Eine Adaption zu einem docker run command sollte kein Problem darstellen.

---version:'3'services:traefik:image:traefik:latestcontainer_name:traefikrestart:alwaysports:-80:80-443:443-8080:8080volumes:-/var/run/docker.sock:/var/run/docker.sock-./traefik:/etc/traefikenvironment:-"TZ=Europe/Berlin"networks:-traefik_proxy-defaultnetworks:traefik_proxy:external:truedefault:driver:bridge

Ports 80 und 443 werden benötigt, um die entsprechenden Seiten dann auch weiterzuleiten. Port 8080 verwenden wir für das Webfrontend von Traefik. Ihr müsst also aufpassen, dass keine anderen Container diese Ports verwenden. Den Traefik Webport könnt ihr auch durch einen anderen ersetzen.

Zudem mounten wir als Volumes den Docker Socket, um Zugriff auf die laufenden Container zu haben. Als zweites Volume nutzen wir für die Konfigurationsdateien für Traefik.

Netzwerke legen wir an, um Traefik von außen erreichbar zu machen (default Netzwerk) und für das interne Routing zu Containern (traefik_proxy).

Traefik Konfiguration

Im Verzeichnis traefik legen wir nun noch die Datei traefik.toml an, welche folgenden Inhalt bekommt:

logLevel ="INFO"defaultEntryPoints = ["http","https"][web] address =":8080"[docker] domain ="example.com" watch =true exposedbydefault =false# Force HTTPS[entryPoints] [entryPoints.http] address =":80" [entryPoints.http.redirect] entryPoint ="https" [entryPoints.https] address =":443" [entryPoints.https.tls]# Let's encrypt configuration[acme] email="youremail.address@example.com" storage="/etc/traefik/acme/acme.json" entryPoint="https" acmeLogging=true OnHostRule=true [acme.httpChallenge] entryPoint ="http"

Wichtig ist, dass ihr eure Domain unter [docker] und eure Email Adresse unter [acme] richtig anpasst. Die Email Adresse wird für dieLet’s encrypt Zertifikate benötigt.

Im Grundsätzlichen war es das schon für das Setup. Um jetzt Docker Container auch dazu zu bringen, auf die entsprechenden Domains zu hören, müssen wir die Konfiguration der einzelnen Container auch anpassen. Hier mal ein Beispiel von „The Lounge“ (einem IRC Frontend)

---version:'3'services:thelounge:image:thelounge/lounge:latestcontainer_name:theloungevolumes:-/var/docker/thelounge:/home/lounge/datalabels:-"traefik.backend=thelounge"-"traefik.enable=true"-"traefik.frontend.rule=Host:subdomain.example.com"-"traefik.port=9000"-"traefik.docker.network=traefik_proxy"networks:-traefik_proxynetworks:traefik_proxy:external:truedefault:driver:bridge

Folgende Werte müsst ihr pro Container anpassen:

• traefik.backend (Name des Backends – könnt ihr frei vergeben)
• traefik.frontend.rule (die URL, auf dem der Service hören soll)
• traefik.port (der Port, auf dem eure Anwendung hört)

Der Rest kann jeweils übernommen werden. Sollte ihr euren Container schon gestartet haben, solltet ihr diesen beenden, evtl. den Container löschen und neu starten. Ein paar Sekunden später ist der Service dann extern verfügbar.