{"title":"Backup & Restore","slug":"backup-restore","category":"guides","summary":"Memories für Backup exportieren, zwischen Minds migrieren, nach Datenverlust wiederherstellen.","audience":["human","llm"],"tags":["guide","backup","restore","migration"],"difficulty":"beginner","updated":"2026-06-27","word_count":246,"read_minutes":1,"lang":"de","translated":true,"requested_lang":"de","content_markdown":"\n# Backup & Restore\n\nSynapse bietet vollständigen Export/Import für Memory-Backup, Migration und\nDisaster-Recovery. Dieser Guide behandelt die essenziellen Operationen.\n\n## Export\n\n### Vollständiger Mind-Export\n\nAlle Memories eines Minds als JSON exportieren:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/mind-export > backup.json\n```\n\nAntwort-Format:\n\n```json\n{\n \"mind_id\": \"m_xyz789\",\n \"mind_name\": \"Work Mind\",\n \"exported_at\": \"2026-06-27T...\",\n \"memory_count\": 142,\n \"memories\": [\n {\n \"id\": \"mem_001\",\n \"category\": \"identity\",\n \"key\": \"user_name\",\n \"content\": \"Michael Schäfer\",\n \"tags\": [\"person\", \"identity\"],\n \"priority\": \"critical\",\n \"source\": \"user\",\n \"verified\": true,\n \"created_at\": \"2026-06-15T...\",\n \"updated_at\": \"2026-06-27T...\"\n }\n ]\n}\n```\n\n### Inkrementeller Export (Diff)\n\nNur Memories exportieren, die seit einem Zeitstempel geändert wurden:\n\n```bash\nSINCE=$(date -d \"2026-06-01\" +%s)\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/diff?since=$SINCE\" > incremental.json\n```\n\nAntwort:\n\n```json\n{\n \"added\": [...],\n \"updated\": [...],\n \"deleted\": [...]\n}\n```\n\n### Automatisierte Backups\n\nTägliche Backups via Cron planen:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/cron \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"schedule\": \"0 2 * * *\",\n \"endpoint\": \"https://synapse.schaefer.zone/memory/mind-export\",\n \"method\": \"GET\",\n \"headers\": {\"Authorization\": \"Bearer YOUR_MIND_KEY\"}\n }'\n```\n\n> [!NOTE]\n> Der Cron-Endpunkt empfängt die Antwort, speichert sie aber nicht. Für echte\n> Backups lasse den Cron auf deinen eigenen Backup-Server zeigen, der die\n> Antwort speichert.\n\n### Besser: externes Backup-Script\n\n```bash\n#!/bin/bash\n# backup-synapse.sh\nMIND_KEY=\"${SYNAPSE_MIND_KEY}\"\nDATE=$(date +%Y%m%d)\nBACKUP_DIR=\"/backups/synapse\"\n\nmkdir -p \"$BACKUP_DIR\"\n\ncurl -s -H \"Authorization: Bearer $MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/mind-export \\\n > \"$BACKUP_DIR/synapse-$DATE.json\"\n\n# Keep last 30 days\nfind \"$BACKUP_DIR\" -name \"synapse-*.json\" -mtime +30 -delete\n\necho \"Backup saved: $BACKUP_DIR/synapse-$DATE.json\"\n```\n\nZur Crontab hinzufügen:\n\n```cron\n0 2 * * * /usr/local/bin/backup-synapse.sh\n```\n\n## Restore\n\n### In denselben Mind wiederherstellen\n\n```bash\n# Parse backup and re-POST each memory\njq -c '.memories[]' backup.json | while read mem; do\n curl -X POST https://synapse.schaefer.zone/memory \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"$(echo \"$mem\" | jq '{category, key, content, tags, priority}')\"\ndone\n```\n\n### In neuen Mind wiederherstellen\n\n```bash\n# 1. Create new mind\nNEW_KEY=$(curl -s -X POST https://synapse.schaefer.zone/minds \\\n -H \"Authorization: Bearer YOUR_JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"name\":\"Restored Mind\",\"description\":\"Restore from backup\"}' \\\n | jq -r .mind_key)\n\n# 2. Import memories to new mind\njq -c '.memories[]' backup.json | while read mem; do\n curl -X POST https://synapse.schaefer.zone/memory \\\n -H \"Authorization: Bearer $NEW_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"$(echo \"$mem\" | jq '{category, key, content, tags, priority}')\"\ndone\n```\n\n### Python-Restore-Script\n\n```python\nimport json\nimport requests\n\nURL = \"https://synapse.schaefer.zone\"\nMIND_KEY = \"mk_...\"\n\ndef restore(backup_file):\n with open(backup_file) as f:\n data = json.load(f)\n \n for mem in data[\"memories\"]:\n requests.post(\n f\"{URL}/memory\",\n headers={\n \"Authorization\": f\"Bearer {MIND_KEY}\",\n \"Content-Type\": \"application/json\"\n },\n json={\n \"category\": mem[\"category\"],\n \"key\": mem[\"key\"],\n \"content\": mem[\"content\"],\n \"tags\": mem.get(\"tags\", []),\n \"priority\": mem.get(\"priority\", \"normal\")\n }\n )\n \n print(f\"Restored {len(data['memories'])} memories\")\n\nrestore(\"backup.json\")\n```\n\n## Migration zwischen Minds\n\n```python\ndef migrate_memories(source_key, target_key):\n \"\"\"Migrate all memories from source mind to target mind.\"\"\"\n # Export from source\n r = requests.get(\n f\"{URL}/memory/mind-export\",\n headers={\"Authorization\": f\"Bearer {source_key}\"}\n )\n data = r.json()\n \n # Import to target\n for mem in data[\"memories\"]:\n requests.post(\n f\"{URL}/memory\",\n headers={\n \"Authorization\": f\"Bearer {target_key}\",\n \"Content-Type\": \"application/json\"\n },\n json={\n \"category\": mem[\"category\"],\n \"key\": mem[\"key\"],\n \"content\": mem[\"content\"],\n \"tags\": mem.get(\"tags\", []),\n \"priority\": mem.get(\"priority\", \"normal\")\n }\n )\n \n print(f\"Migrated {len(data['memories'])} memories\")\n```\n\n## Andere Daten sichern\n\nNicht vergessen zu sichern:\n\n| Datentyp | Endpunkt |\n|-----------|----------|\n| Memories | `GET /memory/mind-export` |\n| Tasks | `GET /mind/tasks` |\n| Scripts | `GET /scripts` |\n| Webhooks | `GET /webhooks` |\n| Cron-Jobs | `GET /cron` |\n| Variables | `GET /var` |\n| Chat-Verlauf | `GET /chat/history?limit=10000` |\n\n## Verifikation\n\nNach dem Restore verifizieren:\n\n```bash\n# Count memories\ncurl -s -H \"Authorization: Bearer $KEY\" \\\n https://synapse.schaefer.zone/memory/stats | jq .total\n\n# Compare with backup\njq .memory_count backup.json\n```\n\n## Best Practices\n\n> [!TIP]\n> - **Täglich sichern** — mit Cron automatisieren\n> - **Restores testen** — ein Backup, das du nicht restoren kannst, ist nutzlos\n> - **Mehrere Versionen aufbewahren** — mindestens 30 Tage\n> - **Offsite speichern** — S3, Backblaze B2 etc.\n> - **Sensible Backups verschlüsseln** — Memories können PII enthalten\n> - **Restore-Prozess dokumentieren** — bis du ihn brauchst, hast du ihn vergessen\n\n## Nächste Schritte\n\n- [Memory-API](/docs/api/memory)\n- [Cron & Scheduler](/docs/api/cron) — für automatisierte Backups\n","content_html":"

Backup & Restore

\n

Synapse bietet vollständigen Export/Import für Memory-Backup, Migration und\nDisaster-Recovery. Dieser Guide behandelt die essenziellen Operationen.

\n

Export

\n

Vollständiger Mind-Export

\n

Alle Memories eines Minds als JSON exportieren:

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/mind-export > backup.json

Antwort-Format:

\n
{\n  "mind_id": "m_xyz789",\n  "mind_name": "Work Mind",\n  "exported_at": "2026-06-27T...",\n  "memory_count": 142,\n  "memories": [\n    {\n      "id": "mem_001",\n      "category": "identity",\n      "key": "user_name",\n      "content": "Michael Schäfer",\n      "tags": ["person", "identity"],\n      "priority": "critical",\n      "source": "user",\n      "verified": true,\n      "created_at": "2026-06-15T...",\n      "updated_at": "2026-06-27T..."\n    }\n  ]\n}

Inkrementeller Export (Diff)

\n

Nur Memories exportieren, die seit einem Zeitstempel geändert wurden:

\n
SINCE=$(date -d "2026-06-01" +%s)\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/diff?since=$SINCE" > incremental.json

Antwort:

\n
{\n  "added": [...],\n  "updated": [...],\n  "deleted": [...]\n}

Automatisierte Backups

\n

Tägliche Backups via Cron planen:

\n
curl -X POST https://synapse.schaefer.zone/cron \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "schedule": "0 2 * * *",\n    "endpoint": "https://synapse.schaefer.zone/memory/mind-export",\n    "method": "GET",\n    "headers": {"Authorization": "Bearer YOUR_MIND_KEY"}\n  }'
Der Cron-Endpunkt empfängt die Antwort, speichert sie aber nicht. Für echte\nBackups lasse den Cron auf deinen eigenen Backup-Server zeigen, der die\nAntwort speichert.

Besser: externes Backup-Script

\n
#!/bin/bash\n# backup-synapse.sh\nMIND_KEY="${SYNAPSE_MIND_KEY}"\nDATE=$(date +%Y%m%d)\nBACKUP_DIR="/backups/synapse"\n\nmkdir -p "$BACKUP_DIR"\n\ncurl -s -H "Authorization: Bearer $MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/mind-export \\\n     > "$BACKUP_DIR/synapse-$DATE.json"\n\n# Keep last 30 days\nfind "$BACKUP_DIR" -name "synapse-*.json" -mtime +30 -delete\n\necho "Backup saved: $BACKUP_DIR/synapse-$DATE.json"

Zur Crontab hinzufügen:

\n
0 2 * * * /usr/local/bin/backup-synapse.sh

Restore

\n

In denselben Mind wiederherstellen

\n
# Parse backup and re-POST each memory\njq -c '.memories[]' backup.json | while read mem; do\n  curl -X POST https://synapse.schaefer.zone/memory \\\n    -H "Authorization: Bearer YOUR_MIND_KEY" \\\n    -H "Content-Type: application/json" \\\n    -d "$(echo "$mem" | jq '{category, key, content, tags, priority}')"\ndone

In neuen Mind wiederherstellen

\n
# 1. Create new mind\nNEW_KEY=$(curl -s -X POST https://synapse.schaefer.zone/minds \\\n  -H "Authorization: Bearer YOUR_JWT" \\\n  -H "Content-Type: application/json" \\\n  -d '{"name":"Restored Mind","description":"Restore from backup"}' \\\n  | jq -r .mind_key)\n\n# 2. Import memories to new mind\njq -c '.memories[]' backup.json | while read mem; do\n  curl -X POST https://synapse.schaefer.zone/memory \\\n    -H "Authorization: Bearer $NEW_KEY" \\\n    -H "Content-Type: application/json" \\\n    -d "$(echo "$mem" | jq '{category, key, content, tags, priority}')"\ndone

Python-Restore-Script

\n
import json\nimport requests\n\nURL = "https://synapse.schaefer.zone"\nMIND_KEY = "mk_..."\n\ndef restore(backup_file):\n    with open(backup_file) as f:\n        data = json.load(f)\n    \n    for mem in data["memories"]:\n        requests.post(\n            f"{URL}/memory",\n            headers={\n                "Authorization": f"Bearer {MIND_KEY}",\n                "Content-Type": "application/json"\n            },\n            json={\n                "category": mem["category"],\n                "key": mem["key"],\n                "content": mem["content"],\n                "tags": mem.get("tags", []),\n                "priority": mem.get("priority", "normal")\n            }\n        )\n    \n    print(f"Restored {len(data['memories'])} memories")\n\nrestore("backup.json")

Migration zwischen Minds

\n
def migrate_memories(source_key, target_key):\n    """Migrate all memories from source mind to target mind."""\n    # Export from source\n    r = requests.get(\n        f"{URL}/memory/mind-export",\n        headers={"Authorization": f"Bearer {source_key}"}\n    )\n    data = r.json()\n    \n    # Import to target\n    for mem in data["memories"]:\n        requests.post(\n            f"{URL}/memory",\n            headers={\n                "Authorization": f"Bearer {target_key}",\n                "Content-Type": "application/json"\n            },\n            json={\n                "category": mem["category"],\n                "key": mem["key"],\n                "content": mem["content"],\n                "tags": mem.get("tags", []),\n                "priority": mem.get("priority", "normal")\n            }\n        )\n    \n    print(f"Migrated {len(data['memories'])} memories")

Andere Daten sichern

\n

Nicht vergessen zu sichern:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
DatentypEndpunkt
MemoriesGET /memory/mind-export
TasksGET /mind/tasks
ScriptsGET /scripts
WebhooksGET /webhooks
Cron-JobsGET /cron
VariablesGET /var
Chat-VerlaufGET /chat/history?limit=10000
\n

Verifikation

\n

Nach dem Restore verifizieren:

\n
# Count memories\ncurl -s -H "Authorization: Bearer $KEY" \\\n     https://synapse.schaefer.zone/memory/stats | jq .total\n\n# Compare with backup\njq .memory_count backup.json

Best Practices

\n

Nächste Schritte

\n\n","urls":{"html":"/docs/guides/backup-restore","text":"/docs/guides/backup-restore?format=text","json":"/docs/guides/backup-restore?format=json","llm":"/docs/guides/backup-restore?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}