{"title":"Backup e ripristino","slug":"backup-restore","category":"guides","summary":"Esporti le sue memorie per backup, migrare tra menti, ripristinare dopo perdita di dati.","audience":["human","llm"],"tags":["guide","backup","restore","migration"],"difficulty":"beginner","updated":"2026-06-27","word_count":270,"read_minutes":1,"lang":"it","translated":true,"requested_lang":"it","content_markdown":"\n# Backup e ripristino\n\nSynapse fornisce export/import completo per backup della memoria, migrazione e\ndisaster recovery. Questa guida copre le operazioni essenziali.\n\n## Export\n\n### Export completo della mente\n\nEsporti tutte le memorie in una mente come JSON:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/mind-export > backup.json\n```\n\nFormato della risposta:\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### Export incrementale (diff)\n\nEsporti solo le memorie modificate da un timestamp:\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\nRisposta:\n\n```json\n{\n \"added\": [...],\n \"updated\": [...],\n \"deleted\": [...]\n}\n```\n\n### Backup automatizzati\n\nPianifichi backup giornalieri tramite cron:\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> L'endpoint cron riceve la risposta ma non la memorizza. Per backup reali,\n> punti il cron al suo server di backup che salva la risposta.\n\n### Meglio: script di backup esterno\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\nAggiunga a crontab:\n\n```cron\n0 2 * * * /usr/local/bin/backup-synapse.sh\n```\n\n## Ripristino\n\n### Ripristino sulla stessa mente\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### Ripristino su una nuova mente\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### Script di ripristino in Python\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## Migrazione tra menti\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## Backup di altri dati\n\nNon dimentichi di fare backup di:\n\n| Tipo di dato | Endpoint |\n|-----------|----------|\n| Memorie | `GET /memory/mind-export` |\n| Attività | `GET /mind/tasks` |\n| Script | `GET /scripts` |\n| Webhook | `GET /webhooks` |\n| Cron job | `GET /cron` |\n| Variabili | `GET /var` |\n| Cronologia chat | `GET /chat/history?limit=10000` |\n\n## Verifica\n\nDopo il ripristino, verifichi:\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 practice\n\n> [!TIP]\n> - **Backup giornaliero** — automatizzi con cron\n> - **Testi i ripristini** — un backup che non può ripristinare è inutile\n> - **Mantenga versioni multiple** — almeno 30 giorni\n> - **Salvi offsite** — S3, Backblaze B2, ecc.\n> - **Cifri i backup sensibili** — le memorie possono contenere PII\n> - **Documenti il processo di ripristino** — lo dimenticherà quando le servirà\n\n## Prossimi passi\n\n- [Memory API](/docs/api/memory)\n- [Cron & Scheduler](/docs/api/cron) — per backup automatizzati\n","content_html":"

Backup e ripristino

\n

Synapse fornisce export/import completo per backup della memoria, migrazione e\ndisaster recovery. Questa guida copre le operazioni essenziali.

\n

Export

\n

Export completo della mente

\n

Esporti tutte le memorie in una mente come JSON:

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

Formato della risposta:

\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}

Export incrementale (diff)

\n

Esporti solo le memorie modificate da un timestamp:

\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

Risposta:

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

Backup automatizzati

\n

Pianifichi backup giornalieri tramite cron:

\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  }'
L'endpoint cron riceve la risposta ma non la memorizza. Per backup reali,\npunti il cron al suo server di backup che salva la risposta.

Meglio: script di backup esterno

\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"

Aggiunga a crontab:

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

Ripristino

\n

Ripristino sulla stessa mente

\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

Ripristino su una nuova mente

\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

Script di ripristino in Python

\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")

Migrazione tra menti

\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")

Backup di altri dati

\n

Non dimentichi di fare backup di:

\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
Tipo di datoEndpoint
MemorieGET /memory/mind-export
AttivitàGET /mind/tasks
ScriptGET /scripts
WebhookGET /webhooks
Cron jobGET /cron
VariabiliGET /var
Cronologia chatGET /chat/history?limit=10000
\n

Verifica

\n

Dopo il ripristino, verifichi:

\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 practice

\n

Prossimi passi

\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"]}