Zum Inhalt springen

Mach mehr aus deinem Server

Betreib Apps auf deiner Hardware mit Sicherungen, Überwachung und eigenen Domains.

Zugang zum Runner anfragen

Verbinde deinen Server

Öffentliche Downloads gibt es noch nicht; für diese Befehle muss der Runner bereits installiert sein.

  • Linux mit Docker Engine und Compose
  • Ausgehendes HTTPS zu usesetup.app
  • Berechtigung zum Hinzufügen von Runnern

  1. Runner → Runner hinzufügen → Token kopieren

    srt_Token wird einmal angezeigt

  2. Runner starten

    shell
    setup-runner run --server https://usesetup.app --token srt_…

    Abruflimits von Docker Hub--registry-mirror mirror.gcr.io

  3. Automatischer Neustart mit systemd

    /etc/systemd/system/setup-runner.service
    [Unit]
Description=Setup runner
Requires=docker.service
After=docker.service network-online.target

[Service]
ExecStart=/usr/local/bin/setup-runner run --server https://usesetup.app --token srt_…
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
    shell
    sudo systemctl daemon-reload && sudo systemctl enable --now setup-runner

  4. Status in Setup prüfen

Gib deinen Apps eine Adresse

Apps wie Vaultwarden brauchen HTTPS; eigene Domains sind auf deinen Runnern kostenlos.

shell
setup-runner run --server https://usesetup.app --token srt_… \
  --public-host 203.0.113.7 \
  --domain apps.example.com --tls acme --acme-email ops@example.com
Ohne Domain
http://192.0.2.10:20004
Wildcard DNS auf deinen Server
*.apps.example.comhttps://wiki.apps.example.com
Öffentlicher Zugang: Ports 80 und 443
80443
Zertifikate von Let’s Encrypt
--tls acme
Interne Zertifikate: auf jedem Gerät vertrauen
--tls internal
Eigene Domains: DNS wird vorher geprüft
wiki.example.com

Nimm bestehende Apps mit

Aktiviere Importe und prüf deine Auswahl unter Runner → Apps von diesem Server holen.

shell
setup-runner run --server https://usesetup.app --token srt_… --allow-import
  1. Bisherige App stoppen
  2. Daten in neue Volumes kopieren
  3. Kopie starten und prüfen
  • Compose, Portainer, CasaOS, Umbrel, Container
  • Einstellungen nur ausgewählter Apps lesen
  • Prüfung fehlgeschlagen: bisherige App neu starten
  • Original bleibt gestoppt; Ordner nie gelöscht
  • Auf Runnern von Setup Cloud ausgeschlossen

Kenne die Grenzen deines Servers

Keine Nutzungsgebühren oder Appkontingente bei Setup; Hardware, Regeln und Funktionen des Teamtarifs gelten weiterhin.

  • Runnerverbindung: ausgehendes HTTPS
  • Apps brauchen eine eigene erreichbare Adresse
  • Auftragsanfragen: bis zu 30 Sekunden
  • Runnertoken als Hashwert gespeichert
  • Standardcontainer teilen den Kernel des Hosts
  • gVisor oder Kata: automatisch, wenn installiert
  • Builds können dein LAN erreichen
  • Eigene VM oder private Netze sperren
  • Widerrufen: Ende bei nächster Anfrage