# Alfahosting Plesk-Server — Einrichtungsplan für Cody

**Erstellt:** 18.06.2026 | **Für:** Cody (Coding-Agent)  
**Auftraggeber:** Daniel Krause (brettspiel-news.de)

---

## Server-Daten

| Eigenschaft | Wert |
|---|---|
| **Anbieter** | Alfahosting |
| **Modell** | Cloud-Server L v3 (Altvertrag, bessere Specs als aktuelle Pro-Reihe) |
| **vCores** | 6 |
| **RAM** | 16 GB |
| **SSD** | 750 GB |
| **Traffic** | Flatrate (unlimited) |
| **Panel** | Plesk |
| **Hostname** | host269.alfahosting-server.de |
| **Preis** | ~19 €/Monat |
| **Standort** | Deutschland |

**Zugangsdaten**: Noch nicht vorhanden. Daniel muss IP + SSH/root-Passwort oder SSH-Key-Zugang bereitstellen.

---

## Was läuft bereits auf dem Server

- **Plesk** (Webhosting-Control-Panel)
- **brettspiel-news.de** (Joomla-Website)
- **E-Mail**: DK@brettspiel-news.de über Alfahosting-Mailserver
- Vermutlich weitere Domains/Websites

---

## Was soll dort hin

### Priorität 1: Hermes Agent (Produktion)
- Eigenständige Hermes-Instanz parallel zum aktuellen Server
- Falls Plesk stört → Hermes in `screen`/`tmux` oder als systemd-Service
- Falls Plesk OHNE root-Zugang → Hermes als User-Service unter dem Web-User

### Priorität 2: Language Worker (BSN Chatbot)
- faster-whisper für Audio-Transkription
- Piper TTS (de_DE-thorsten-medium + weitere Stimmen)
- ffmpeg für Video-Thumbnails
- REST-API nach dem Muster aus `~/workspace/bsn-server-split-plan.md`

### Priorität 3: Optionales
- Fallback/Redundanz für den aktuellen 4-Kern-Server
- Voice-Webapp (Port 5001)
- Entwicklungs-/Staging-Umgebung

---

## Migrations-Schritte

### Phase 1: Zugang + Bestandsaufnahme
1. Daniel gibt SSH-Zugang (IP + User + Passwort/Key)
2. SSH-Verbindung testen
3. Bestehende Plesk-Installation prüfen — läuft Apache/nginx? Welche PHP-Version?
4. Freie Ports checken (5002, 8890, etc.)
5. Verfügbaren RAM/Disk prüfen

### Phase 2: Python-Umgebung
6. Python 3.11+ installieren (falls nicht vorhanden)
7. Venv anlegen: `python3 -m venv /opt/hermes-venv`
8. Basis-Pakete: `pip install flask faster-whisper requests`
9. Piper TTS Binary + deutsche Stimmen installieren
10. ffmpeg installieren (falls nicht vorhanden)

### Phase 3: Hermes Agent
11. Hermes per Install-Script oder pip installieren
12. Profile anlegen (mindestens ein Produktions-Profil)
13. Skills aus dem Hauptserver kopieren/synchronisieren
14. Telegram/Discord-Gateway konfigurieren
15. Model-Provider einrichten (DeepSeek direkt, sk-53fc...)

### Phase 4: BSN Language Worker
16. `language_server.py` aus split-plan deployen
17. Whisper-Modell laden und testen
18. TTS-Endpunkt testen
19. Health-Check einrichten

### Phase 5: Integration
20. Aktuellen BSN-Chatbot (4-Kern-Server) auf Language-Worker umbiegen
21. Integrationstest: Sprachnachricht schicken → Transkription prüfen
22. Monitoring: Cron-Job für Health-Checks

---

## Plesk-spezifische Fallstricke

- **Plesk läuft meist auf Port 8443** (Admin) und 80/443 (Web)
- Port 5002 und 8890 sollten frei sein
- **Kein root?** Plesk-User hat oft sudo-Rechte nicht — Hermes müsste als User-Service laufen
- **Apache/nginx** könnte im Weg sein — Reverse-Proxy für Hermes-Ports konfigurieren
- **PHP-FPM** läuft parallel — RAM-Verbrauch einplanen

---

## Noch zu klären (Daniel fragen)

- [ ] IP-Adresse des Servers?
- [ ] root-Zugang oder Plesk-Admin-Zugang?
- [ ] SSH-Port (Standard 22 oder abweichend)?
- [ ] Soll Hermes unter einer Subdomain laufen (z.B. hermes.brettspiel-news.de)?
- [ ] Soll Plesk parallel weiterlaufen oder kann es deaktiviert werden?
- [ ] Backup-Strategie für den neuen Server?

---

## Referenz-Dokumente

- `~/workspace/bsn-server-split-plan.md` — Detaillierte Architektur für Web/Language-Split
- `~/workspace/article_server.py` — Article Server (Port 8890, Joomla-API-Integration)
- `~/.hermes/profiles/cody/` — Codys Profil (Vorlage für neue Profile)
- `~/.hermes/skills/software-development/bsn-chatbot/` — BSN Chatbot Skill
- `~/.hermes/skills/software-development/article-management/` — Article Management Skill
