Erste Schritte

In 5 Minuten lauffähig#

Sie brauchen keinen Server, keinen Hosting-Anbieter und keine IT-Abteilung. Wenn Sie einen Laptop mit installiertem Docker haben, können Sie Observer sofort ausprobieren.

git clone https://github.com/lbrty/observer.git
cd observer
cp .env.example .env
just generate-keys
just docker-up
just run

Öffnen Sie http://localhost:9000/health in Ihrem Browser. Wenn Sie "status":"healthy" sehen, läuft das Backend.

Starten Sie dann die Weboberfläche:

just web-dev

Öffnen Sie http://localhost:5173 — Sie sehen Observer.

Was Sie gerade gestartet haben#

Sie haben jetzt ein Backend auf :9000, ein Frontend auf :5173 und ein Postgres + Redis-Paar in Docker — alles auf einer einzigen Maschine.

Bereit für den Produktiveinsatz?#

Um von „Ausprobieren" zu „Mein Team nutzt das täglich" zu kommen, brauchen Sie:

Kein Abonnement. Keine nutzerbezogenen Gebühren. Kein Vendor Lock-in. Die Daten und die Bereitstellung gehören Ihnen.

Siehe Bereitstellung für die schrittweise Produktionseinrichtung.

Für Entwickler: Lokale Einrichtung#

Wenn Sie an Observer selbst arbeiten möchten, benötigen Sie folgende Tools:

1. Klonen und Abhängigkeiten installieren#

git clone https://github.com/lbrty/observer.git
cd observer
go mod download
bun install

2. Umgebung konfigurieren#

cp .env.example .env

Die Standardwerte funktionieren sofort mit der mitgelieferten docker-compose.yml. Keine Bearbeitung nötig.

3. Signaturschlüssel generieren#

just generate-keys

Dies erstellt ein Schlüsselpaar, das Observer zum Signieren von Login-Tokens verwendet. Das keys/-Verzeichnis ist in .gitignore — jeder Entwickler generiert sein eigenes.

4. Alles starten#

just docker-up    # startet PostgreSQL und Redis
just run          # startet das Backend auf :9000 (führt Migrationen automatisch aus)
just web-dev      # startet das Frontend auf :5173

Etwas funktioniert nicht?#

Port 5432 bereits belegt — Wahrscheinlich läuft ein lokales PostgreSQL. Stoppen Sie es oder ändern Sie den Port in docker-compose.yml.

“no such file or directory” für Schlüsselpfade — Sie müssen zuerst just generate-keys ausführen.

Migration schlägt mit “connection refused” fehl — Der Datenbank-Container ist möglicherweise noch nicht bereit. Warten Sie einige Sekunden nach just docker-up und versuchen Sie es erneut.