App-Bibliothek – zeltro install

zeltro install <app> [name] richtet eine fertige App von Dritten ein, vollständig konfiguriert und lauffähig, meist in weniger als zwei Minuten. Öffnen Sie sie unter der Adresse, die zeltro status <app> anzeigt.

zeltro install grafana       # monitoring dashboards
zeltro install gitea         # self-hosted git
zeltro install n8n           # workflow automation
zeltro install nextcloud     # file hosting
zeltro install --list        # everything available

Wenn Sie ein Projekt anlegen wollen, das Sie selbst schreiben, lesen Sie stattdessen Frameworks. Erwischen Sie den falschen Befehl, verweist Zeltro Sie auf den richtigen.

Was ein Installer für Sie erledigt#

Jeder Installer hält die Eigenheiten einer App einmal fest, damit Sie (oder Ihr Agent) sie nie wieder neu herausfinden müssen:

• Legt die Datenbank der App im gemeinsamen Dienst an, dazu einen eigenen Datenbankbenutzer, wenn die App nicht als root laufen will
• Erzeugt Secrets und App-Schlüssel
• Schreibt eine Compose-Datei, die mit Zeltros gemeinsamen Diensten verbunden ist statt mit mitgelieferten Datenbanken
• Gibt der App eine feste IP in Zeltros Netzwerk, einen Containernamen, unter dem andere Container sie erreichen, und einen veröffentlichten Host-Port (die letzte Zahl der IP) für die LAN-Adresse
• Stellt die eigene URL der App vor dem ersten Start auf diese IP ein (siehe unten)
• Startet den Container und wartet, bis er über HTTP antwortet

Die eigene URL der App#

Die meisten Apps müssen ihre öffentliche URL kennen (APP_URL, ROOT_URL, NEXTAUTH_URL und so weiter), und viele leiten Sie dorthin um oder lehnen jede andere Adresse ab. Zeltro schreibt nicht in /etc/hosts, deshalb ist der Projektname keine URL, die Ihr Browser öffnen kann. Vor dem ersten Start der App setzt zeltro install diese URL auf die Container-IP des Projekts: Aus http://grafana/ wird http://10.247.177.124/.

Die IP wird verwendet und kein localhost-Port, weil sie sowohl in Ihrem Browser unter Linux funktioniert als auch aus anderen Containern heraus, auf jedem Betriebssystem. Apps, die den Hostnamen selbst prüfen (die vertrauenswürdigen Domains von Nextcloud und ownCloud, Kimai, Readeck, ESPHome, Baby Buddy, Healthchecks), akzeptieren sowohl die IP als auch den Projektnamen.

Bei einigen Apps gehört die Adresse fest zu ihrer Identität. Dort lässt Zeltro den Projektnamen stehen:

• Mastodon behält den Namen in LOCAL_DOMAIN und WEB_DOMAIN und trägt die IP in ALTERNATE_DOMAINS ein, damit es auch dort antwortet. Start- und Entdecken-Seite laden unter der IP, aber Mastodon geht im Produktivbetrieb von HTTPS aus: Seine Cookies sind als Secure markiert, und die schickt ein Browser nicht über einfaches http://. Einige Weiterleitungen (etwa von der Registrierung zur Anmeldung) zeigen außerdem auf https://. Zum Anmelden brauchen Sie HTTPS davor.
• Lemmy behält den Namen als hostname in lemmy.hjson. Seine Weboberfläche spricht die API unter der IP an.
• Pixelfed ist die Ausnahme: Es liefert Seiten nur unter APP_DOMAIN aus, deshalb wird dort die IP eingetragen.

Neuere Installer legen Image-Tags auf bestimmte Versionen fest statt auf :latest. Eine Installation, die gestern funktioniert hat, funktioniert heute genauso, und Upgrades passieren nur mit Absicht. Einige ältere Installer nutzen noch gleitende Tags; siehe Verfügbare Apps.

Optionen#

zeltro install livewire sign-tools
zeltro install livewire sign-tools --image canebaycomputers/cbc:nginx-php8-vector

Eine App entfernen#

zeltro remove grafana                    # stop it and trash the files; data is kept
zeltro remove grafana --force-db-delete  # also drop its databases, DB users and volumes

--force-db-delete löscht, was die App tatsächlich nutzt, nicht eine Datenbank, die nach dem Projekt benannt ist. Die Namen der Datenbanken und Benutzer liest es aus den Compose- und .env-Dateien des Projekts und aus den Zeilen CREATE DATABASE / CREATE USER des Installers, der es angelegt hat. Wer also zeltro install freescout helpdesk entfernt, löscht die Datenbank freescout und den MariaDB-Benutzer freescout. Eine Datenbank oder ein Benutzer, den auch die Dateien eines anderen Projekts nennen, bleibt erhalten, und die Ausgabe weist darauf hin.

Installer aktuell halten#

zeltro update-installer <app>     # refresh one against current upstream, via AI
zeltro update-installer --all
zeltro create-installer "<idea>"  # write a brand-new installer, via AI

Beide geben einen vorbereiteten Prompt aus, der einen Agenten anweist, den aktuellen Upstream-Stand zu holen, ihn mit dem bestehenden Installer zu vergleichen, den Installer neu zu erzeugen, ihn von Anfang bis Ende zu prüfen und zu committen.

Verfügbare Apps#

Es gibt 214 Apps. Ehrlich gesagt, was geprüft wurde und was nicht, denn „über 200 Apps“ ist schnell gesagt und schwer zu belegen:

• 125 wurden auf einem echten Rechner installiert, über HTTP geprüft und wieder entfernt: 114 kamen mit der Katalogerweiterung im August 2026 hinzu, dazu 11 ältere, die seitdem stichprobenartig geprüft wurden. Jede davon legt ihre Images auf bestimmte Versionen fest.
• 89 sind ältere Einträge, die vor diesem Verfahren entstanden sind. Sie wurden geschrieben und benutzt, haben das Verfahren aber nicht durchlaufen, und die meisten folgen noch gleitenden Tags wie :latest. Gut möglich, dass sie funktionieren; nachgewiesen hat es in letzter Zeit niemand.

Wenn eine ältere App Probleme macht, melden Sie es. So wird sie am schnellsten repariert.

Einen Fehler in dieser Übersetzung gefunden? Sagen Sie es uns auf GitHub.