Unleash einfach selbst hosten

Unleash einfach selbst hosten

Yulei Chen - Content-Engineerin bei sliplane.ioYulei Chen
6 min

Unleash ist die führende Open-Source-Plattform für Feature-Flag-Management. Damit kannst du Features schrittweise ausrollen, A/B-Tests fahren und kaputte Releases per Kill-Switch sofort stoppen. Unleash Cloud funktioniert, aber die Preise skalieren mit Seats und Feature Flags - und du gibst die Kontrolle über eine kritische Deployment-Komponente ab.

Sliplane ist eine Managed-Container-Plattform, die Self-Hosting einfach macht. Mit One-Click Deployment hast du Unleash in wenigen Minuten am Laufen - kein Server-Setup, keine Reverse-Proxy-Konfiguration, keine Infrastruktur zum Warten.

Voraussetzungen

Vor dem Deployment brauchst du einen Sliplane Account (kostenlose Testphase verfügbar).

Du brauchst außerdem eine PostgreSQL-Datenbank. Unleash speichert alle Daten in Postgres, also muss eine Instanz laufen, bevor du deployst. Du kannst PostgreSQL auf Sliplane deployen - mit nur wenigen Klicks über das Postgres-Preset.

Quick Start

Sliplane bietet One-Click Deployment mit Presets.

SliplaneUnleash deployen >
  1. Klick auf den Deploy-Button oben
  2. Wähl ein Projekt aus
  3. Wähl einen Server aus (bei Neuanmeldung bekommst du einen 48-Stunden-Testserver gratis)
  4. Klick auf Deploy!

Über das Preset

Das One-Click Deployment nutzt Sliplane's Unleash-Preset. Das steckt drin:

  • Offizielles unleashorg/unleash-server Image in Version 7.6.4
  • Healthcheck auf /health konfiguriert
  • Standard-Admin-Passwort (automatisch generiert, sichtbar in den Service-Settings)
  • Vorkonfigurierte Frontend- und Client-API-Tokens für schnelles SDK-Setup
  • LOG_LEVEL auf warn gesetzt für saubere Logs
  • UNLEASH_URL automatisch auf deine Sliplane-Domain konfiguriert

Das Preset erwartet, dass du deine eigene PostgreSQL-Verbindung über die Umgebungsvariable DATABASE_URL angibst. Nach dem Deployment aktualisierst du diesen Wert mit deiner Postgres-Instanz.

Nächste Schritte

Sobald Unleash läuft, öffne die Domain, die Sliplane dir zugewiesen hat (z.B. unleash-xxxx.sliplane.app).

Standard-Zugangsdaten

Meld dich an mit:

  • Benutzername: admin
  • Passwort: der Wert von UNLEASH_DEFAULT_ADMIN_PASSWORD in deinen Service-Settings

Änder das Admin-Passwort nach dem ersten Login.

Verbindung zu PostgreSQL

Das Preset wird mit einer Platzhalter-DATABASE_URL ausgeliefert. Du musst sie auf deine tatsächliche PostgreSQL-Instanz anpassen. Wenn du Postgres auf demselben Sliplane-Server deployt hast, nutz den internen Hostnamen:

postgres://postgres:DEIN_PASSWORT@DEIN-POSTGRES-SERVICE.internal:5432/unleash

Ersetze DEIN_PASSWORT mit deinem Postgres-Passwort und DEIN-POSTGRES-SERVICE mit dem Namen deines Postgres-Service (sichtbar im Sliplane Dashboard). Achte drauf, dass die Datenbank unleash auf deiner Postgres-Instanz existiert, bevor du Unleash startest.

API Tokens

Das Preset enthält zwei vorkonfigurierte API-Tokens für die Entwicklung:

Token-TypToken-Wert
Frontend APIdefault:default:development.unleash-insecure-frontend-api-token
Client APIdefault:development.unleash-insecure-api-token

Die sind gut zum Testen, aber für den Produktivbetrieb solltest du neue Tokens im Unleash Admin-Panel erstellen.

Umgebungsvariablen

Hier sind die wichtigsten Umgebungsvariablen, die du anpassen kannst:

VariableStandardBeschreibung
UNLEASH_DEFAULT_ADMIN_PASSWORD(auto-generiert)Admin-Login-Passwort
DATABASE_URL(Platzhalter)PostgreSQL Connection String
DATABASE_SSLfalseSSL für Datenbankverbindungen aktivieren
LOG_LEVELwarnLog-Detail (debug, info, warn, error)

Logging

Unleash loggt standardmäßig auf STDOUT, was perfekt mit Sliplane's eingebautem Log-Viewer funktioniert. Wenn du mehr Details zum Debuggen brauchst, setz LOG_LEVEL auf info oder debug. Für allgemeine Docker-Log-Tipps schau dir unseren Post zu Docker Logs an.

Troubleshooting

Wenn Unleash nicht startet, prüf diese häufigen Probleme:

  • Datenbankverbindung: Achte drauf, dass DATABASE_URL korrekt ist und der Postgres-Service läuft
  • Datenbank nicht erstellt: Unleash braucht eine existierende Datenbank. Verbinde dich mit Postgres und führ CREATE DATABASE unleash; aus
  • Port-Konflikt: Unleash hört standardmäßig auf Port 4242. Das Preset setzt das über die PORT-Variable

Kostenvergleich

Du kannst Unleash auch bei anderen Cloud-Anbietern selbst hosten. Hier ein Preisvergleich der gängigsten:

AnbietervCPURAMDiskMonatliche KostenHinweis
Sliplane22 GB40 GB€9 (~$10,65)Flatrate, 1 TB Bandwidth, SSL inklusive
Fly.io22 GB40 GB~$18Disk und Bandwidth extra
Render12 GB40 GB~$35100 GB Bandwidth, Disk extra
Railway22 GB40 GB~$67 + $20 PlanPro-Plan-Minimum, nutzungsbasiert, Bandwidth extra
Klick hier, um zu sehen, wie diese Zahlen berechnet wurden.

(Angenommen: eine dauerhaft laufende Instanz mit 730 Stunden/Monat)

  • Sliplane: pauschal €9/Monat für den Base-Server. Unbegrenzte Services auf demselben Server, 1 TB Egress und SSL inklusive.
  • Fly.io: shared-cpu-2x 2 GB = $11,83/Mo + 40 GB Volume × $0,15/GB = $6 -> ~$17,83/Mo. Egress extra ($0,02/GB in EU).
  • Render: nächste Stufe ist Standard ($25, 1 vCPU / 2 GB) plus 40 GB Disk × $0,25/GB = $10 -> ~$35/Mo. Pro (2 vCPU / 4 GB) kostet $85/Mo + Disk.
  • Railway (Pro-Plan): CPU 2 × $0,00000772/s × 2.628.000 s = $40,57; RAM 2 × $0,00000386/s × 2.628.000 s = $20,29; Volume 40 × $0,00000006/s × 2.628.000 s = $6,31 -> ~$67/Mo Compute, plus $20/Mo Pro-Plan-Minimum und $0,05/GB Egress.

Bandwidth-Kosten können bei nutzungsbasierten Anbietern schnell steigen. Nutz unser Bandwidth-Kostenvergleichs-Tool, um zu sehen, was dein Egress bei jedem Anbieter kosten würde.

FAQ

Wofür kann ich Unleash nutzen?

Unleash wird für Feature-Flag-Management eingesetzt. Du kannst neue Features schrittweise an einen Prozentsatz der Nutzer ausrollen, A/B-Tests fahren, Features ohne Redeployment ein- und ausschalten und Kill-Switches für kaputte Releases erstellen. Es gibt SDKs für alle gängigen Sprachen und Frameworks.

Wie verbinde ich meine App mit Unleash?

Installier das Unleash SDK für deine Sprache (Node.js, Python, Java, Go, .NET, Ruby, etc.) und richte es auf deine Unleash-Instanz-URL. Nutz den Client-API-Token aus deinen Service-Settings zur Authentifizierung. Die Unleash SDK Docs beschreiben das Setup für jede Sprache.

Wie update ich Unleash?

Änder den Image-Tag in deinen Sliplane Service-Settings (z.B. von 7.6.4 auf eine neuere Version) und deploye neu. Prüf auf Docker Hub die neueste stabile Version. Unleash führt Datenbank-Migrationen beim Start automatisch durch.

Braucht Unleash viele Ressourcen?

Nein. Unleash ist leichtgewichtig und läuft problemlos auf kleinen Instanzen. Ein 2 vCPU / 2 GB RAM Server schafft tausende Feature-Flag-Auswertungen pro Sekunde. Der Flaschenhals ist meistens die Datenbank, nicht der Unleash-Server selbst.

Kann ich Unleash ohne PostgreSQL nutzen?

Nein. PostgreSQL ist die einzige unterstützte Datenbank für Unleash. Du kannst einen Managed-Postgres-Service nutzen oder PostgreSQL auf Sliplane selbst hosten - auf demselben Server. Unleash und Postgres passen für die meisten Workloads bequem auf einen einzelnen Sliplane Base-Server.

Jetzt Unleash selbst hosten - ganz einfach!

Sliplane gibt dir alles, was du brauchst, um Unleash ohne Server-Stress zu betreiben.