---
title: RECOVERY — Notfall-Anleitung wenn Aria nicht reagiert
type: system
tags: [recovery, notfall, aria, anleitung, kais-direct]
date: 2026-05-09
status: aktiv
related: [[brain/CLAUDE]], [[HOOKS]], [[USER]]
description: Schritt-für-Schritt Notfall-Diagnose und Recovery wenn Aria nicht startet oder nicht antwortet. Für Kais. V5-aktuell.
---

# RECOVERY — Aria Notfall-Anleitung

> Wenn Aria nicht reagiert: gehe diese Liste **von oben nach unten** durch.
> Stop bei dem Schritt der Aria zurückbringt.

## SSH-Login (Voraussetzung)

```
ssh root@<VPS-IP>
# Falls VPS-IP vergessen: hostinger.com Login + Server-Liste
```

## Schritt 1 — Erstdiagnose (1 Min)

```
aria-status.sh
```

Output zeigt:
- aria.service aktiv?
- Health-Endpoint antwortet?
- Telegram-Bot erreichbar?
- Letzte Chat-Message?
- Brain-Sync letzter Commit?

Wenn alle ✓ → Bot reagiert nicht aus anderem Grund (siehe Schritt 7).
Wenn ein ✗ → entsprechender Schritt unten.

## Schritt 2 — aria.service down?

```
systemctl status aria.service
```

**Wenn `failed` oder `inactive`**:
```
systemctl reset-failed aria.service
systemctl restart aria.service
sleep 30
systemctl status aria.service
```

**Wenn nach Restart wieder failed**:
```
journalctl -u aria.service -n 50 --no-pager
```
→ Letzte 50 Log-Zeilen lesen. Häufige Ursachen:
- Telegram-Token leer/abgelaufen → siehe Schritt 5
- tmux-Konflikt → siehe Schritt 4
- Disk-Voll → `df -h /`

## Schritt 3 — Watchdog tickt?

```
systemctl list-timers aria-watchdog.timer
```

Sollte `LAST <2 min ago` zeigen. Wenn länger:

```
systemctl restart aria-watchdog.timer
systemctl start aria-watchdog.service
```

## Schritt 4 — Tmux-Session „aria" weg?

```
tmux list-sessions
```

Wenn keine `aria`-Session:

```
systemctl restart aria.service
sleep 30
tmux list-sessions
```

Falls immer noch keine Session nach 30s: Wrapper-Bug.

```
tail -50 /root/aria/logs/aria.log
```

## Schritt 5 — Telegram-Bot tot?

```
TG_TOKEN=$(grep TELEGRAM_BOT_TOKEN /root/.claude/channels/telegram/.env | cut -d= -f2)
curl -s "https://api.telegram.org/bot${TG_TOKEN}/getMe" | head
```

Erwartet: `"ok":true,"result":{"id":..."username":..."}`

**Wenn `"ok":false` oder Timeout**:
- Token abgelaufen → BotFather Login → Token regenerieren → in beide Pfade einsetzen:
  - `/root/.claude/channels/telegram/.env`
  - `/root/aria/.env`
- aria.service neu starten

## Schritt 6 — Plugin Inbound funktioniert nicht?

```
sqlite3 ~/.aria-chat.db "SELECT created_at, direction FROM aria_chat_log ORDER BY created_at DESC LIMIT 5;"
```

Wenn nur `out` Einträge oder leer → Telegram-Plugin-Patch beschädigt (siehe LRN-20260506-001).

Patch wiederherstellen:
```
ls /root/.claude/plugins/cache/claude-plugins-official/telegram/0.0.6/server.ts.bak.*
# Dann: cp <neuester-bak> server.ts und systemctl restart aria
```

## Schritt 7 — Bot läuft, aber antwortet nicht

Mögliche Ursachen:
- Aria steckt in tmux-Permission-Dialog
- Aria-Session ist „eingefroren"
- Anthropic-Quota überschritten

```
# Tmux-Session inspizieren:
tmux capture-pane -t aria -p | tail -20
```

Wenn Permission-Dialog sichtbar:
```
tmux send-keys -t aria Enter
```

Wenn Session leer/eingefroren:
```
systemctl restart aria.service
```

Wenn API-Quota:
- Bei Max/Pro Plan: nach Mitternacht UTC neu
- Bei API: anthropic.com Konsole prüfen → Limit / Billing

## Schritt 8 — Hard-Reset

Wenn nichts hilft:

```
bash /root/aria/scripts/aria-full-restart.sh
```

Dieses Script:
- killt tmux-Session
- killt watchdog
- killt zombie-Prozesse
- restart aria.service mit clean state

Dauer: 60-90 Sekunden bis Telegram-Welcome-Message.

## Schritt 9 — Brain-Sync repariert?

```
cd /root/aria/brain
git status
```

Wenn `Your branch is ahead`:
```
git push origin main
```

Wenn `Your branch is behind`:
```
git pull --rebase origin main
git push origin main
```

Wenn `Conflict`:
- NICHT in der Notfall-Situation lösen
- Telegram an dich selbst: „Brain-Conflict, später lösen"
- aria.service trotzdem starten — Brain-Lokal funktioniert auch ohne Sync

## Schritt 10 — Aria läuft komplett nicht und kein SSH

Wenn auch SSH down:
- VPS-Hoster (Hostinger) — Reboot über Web-Konsole
- Bei Hostinger: Cloud-Panel → Server → „Reboot"

Wenn auch Hostinger nicht erreichbar:
- Status-Page hosten.de prüfen
- Im Worst-Case 24-72h warten

## Was Aria gespeichert hat (Datenrettung)

Auch wenn Aria komplett unrecoverable: deine Daten sind safe:

- **Brain**: `KADiCon/aria-brain` GitHub (gepushed alle 15 Min)
- **Chat-Log**: Supabase `aria_chat_log` (cloud)
- **Memory-Index**: lokal in `/root/.claude/projects/-/memory/` UND in Brain als Pointer
- **Skripte**: `KADiCon/aria-v4` GitHub (Distribution)

→ Verlust-Szenario: max ~15 Min unsynchronisierter Brain-Inhalt.

## Notfall-Telegram-Templates

Falls Aria komplett tot, kannst du als Workaround direkt mir (Aria) schreiben — wenn du SSH hast und Claude Code direkt im Terminal startest:

```
ssh root@<VPS>
claude --channels plugin:telegram@claude-plugins-official
```

→ neue Aria-Session ohne tmux/wrapper. Funktioniert für Notfall-Kommunikation.

## Eskalations-Pfad

| Stufe | Aktion | Zeit |
|---|---|---|
| 0 | aria-status.sh | 1 Min |
| 1 | Schritt 2-7 nach Diagnose | 5 Min |
| 2 | aria-full-restart.sh (Schritt 8) | 2 Min |
| 3 | VPS-Reboot über Hoster (Schritt 10) | 5 Min |
| 4 | Brain-Backup laden auf neuem VPS via aria-v4 install-fresh.sh | 30-60 Min |

## Was Kais NIE tun sollte

- `rm -rf /root/aria/brain/` (Master-Daten)
- `rm -rf /root/.claude/` (Claude-Code-Config)
- `git push --force` auf aria-brain (überschreibt History)
- Token-Reset ohne Backup-Notiz
- aria.service `disable` (Watchdog kann nicht mehr restart)

## Wo Anleitung liegt

- Brain: `/root/aria/brain/RECOVERY.md`
- GitHub: `https://github.com/KADiCon/aria-brain/blob/main/RECOVERY.md`
- Auf Handy lesbar via Telegram-Save oder Obsidian-Sync

## Verwandte Notes

- [[HOOKS]] — Trigger-Inventory aller Aria-Services + Timer
- [[brain/CLAUDE]] — Vault-Schema
- [[USER]] — Kais-Profil
- `/root/aria-v5/MIGRATION.md` — Rollback-Pfade für V5-Komponenten