74 lines
2.3 KiB
Markdown
74 lines
2.3 KiB
Markdown
# Beeper Bridges - Docker Setup
|
|
|
|
Dieses Projekt verwaltet selbst-gehostete Matrix-Bridges für Beeper mittels Docker Compose.
|
|
|
|
## Struktur
|
|
- `docker-compose.yml`: Definition der Dienste (WhatsApp, Telegram, Signal, Google Chat).
|
|
- `data/`: Persistente Daten für die Bridges (Configs + SQLite Datenbanken).
|
|
- `migrate.sh`: Hilfsskript zum Importieren bestehender lokaler Installationen.
|
|
|
|
## Installation
|
|
|
|
### Option A: Migration bestehender Daten
|
|
Wenn du die Bridges vorher manuell (ohne Docker) betrieben hast, nutze das Skript, um Configs und Datenbanken zu importieren. Das Skript passt automatisch die Datenbank-Pfade für Docker an.
|
|
|
|
```bash
|
|
./migrate.sh
|
|
```
|
|
|
|
### Option B: Neuinstallation (Greenfield)
|
|
Wenn du noch keine lokalen Bridges hast:
|
|
|
|
1. **Ordnerstruktur anlegen:**
|
|
(Wird automatisch durch git clone erledigt, da .gitkeep Dateien existieren)
|
|
|
|
2. **Standard-Configs generieren:**
|
|
Starte die Container kurz, damit sie die Standard-`config.yaml` Dateien erzeugen. Die Container werden sich danach beenden oder neustarten, weil die Registrierung fehlt.
|
|
```bash
|
|
docker compose up
|
|
```
|
|
*Hinweis: Breche den Vorgang mit `Ctrl+C` ab, sobald die Configs erstellt wurden.*
|
|
|
|
3. **Registrierung (WICHTIG):**
|
|
Damit Beeper die Bridges akzeptiert, benötigst du für jede Bridge eine `registration.yaml`. Diese erstellst du am besten mit dem offiziellen Tool [`bbctl`](https://github.com/beeper/bridge-manager) lokal auf deinem Rechner.
|
|
|
|
Beispiel:
|
|
```bash
|
|
bbctl register whatsapp
|
|
mv registration.yaml data/whatsapp/
|
|
```
|
|
|
|
4. **Konfiguration anpassen:**
|
|
Bearbeite die `data/<bridge>/config.yaml` falls nötig. Achte darauf, dass `sqlite:////data/bridge.db` als Datenbankpfad gesetzt ist.
|
|
|
|
## Starten
|
|
Startet alle Bridges.
|
|
|
|
```bash
|
|
# Im Hintergrund (Daemon)
|
|
docker compose up -d
|
|
|
|
# Oder um alle Logs direkt zu sehen (zum Debuggen)
|
|
docker compose up
|
|
```
|
|
|
|
## Logs & Login
|
|
Falls du dich neu anmelden musst (QR-Code Scan), findest du den Code in den Logs oder im Beeper "Bridge Bot" Chat.
|
|
|
|
```bash
|
|
docker compose logs -f whatsapp
|
|
```
|
|
|
|
## Wartung
|
|
|
|
**Update der Bridges:**
|
|
```bash
|
|
# Zieht die Images nacheinander (vermeidet Timeouts)
|
|
docker compose pull
|
|
|
|
# Startet neu
|
|
docker compose up -d
|
|
```
|
|
|
|
**Backup:**
|
|
Sichere einfach den kompletten `data/` Ordner. Er enthält alle Sitzungen und Schlüssel. |