Schnellstartanleitung

1. Konfiguration erstellen

nostrfy init schreibt eine standardmäßige, vollständig kommentierte nostrfy.toml:

nostrfy --config nostrfy.toml init

Öffnen Sie sie in einem Texteditor und passen Sie sie an — jede Option ist kommentiert.

2. Konfiguration validieren

nostrfy check wird vor dem Start dringend empfohlen; bei Problemen meldet er genau, was falsch ist.

nostrfy --config nostrfy.toml check

3. Relay starten

nostrfy --config nostrfy.toml start

Läuft als Daemon. Mit --foreground im Terminal.

Prüfen Sie dann mit dem Health-Endpunkt, ob das Relay läuft:

curl http://127.0.0.1:8080/health

=> {"status":"ok"}

4. Client verbinden

Verbinden Sie sich auf derselben Maschine mit ws://<host>:8080. Der Standard-Host ist 127.0.0.1, der nur lokale Verbindungen akzeptiert. Um das Relay von anderen Maschinen zu erreichen, setzen Sie in der Konfiguration server.host = "0.0.0.0":

[server]
host = "0.0.0.0"

Für wss:// benötigen Sie einen TLS-terminierenden Proxy (nginx oder Caddy) davor — siehe die Bereitstellungs-Dokumentation.

5. Stoppen und neu starten

nostrfy --config nostrfy.toml stop
nostrfy --config nostrfy.toml restart
kill -HUP $(cat nostrfy.pid)  # Konfiguration ohne Neustart neu laden

restart liest die Konfiguration neu ein; SIGHUP lädt die meisten Einstellungen ohne Neustart neu.

Effektiver Betrieb

• nostrfy stats zeigt Live-Statistiken — auch über HTTP unter /relay/stats und /metrics.
• Das Log wird nach daemon.log_file geschrieben und automatisch rotiert.
• RUST_LOG steuert die Log-Stufe (z. B. RUST_LOG=nostrfy=debug).