{"title":"Yedekleme & Geri Yükleme","slug":"backup-restore","category":"guides","summary":"Yedekleme için belleklerinizi dışa aktarın, mind'ler arasında taşıyın, veri kaybından sonra geri yükleyin.","audience":["human","llm"],"tags":["guide","backup","restore","migration"],"difficulty":"beginner","updated":"2026-06-27","word_count":254,"read_minutes":1,"lang":"tr","translated":true,"requested_lang":"tr","content_markdown":"\n# Yedekleme & Geri Yükleme\n\nSynapse, bellek yedekleme, taşıma ve felaket kurtarma için tam dışa/içe aktarma sağlar. Bu rehber temel işlemleri kapsar.\n\n## Dışa Aktarma\n\n### Tam Mind Dışa Aktarımı\n\nBir mind'deki tüm bellekleri JSON olarak dışa aktar:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/mind-export > backup.json\n```\n\nYanıt biçimi:\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### Artımlı Dışa Aktarma (Diff)\n\nYalnızca bir zaman damgasından sonra değişen bellekleri dışa aktar:\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\nYanıt:\n\n```json\n{\n \"added\": [...],\n \"updated\": [...],\n \"deleted\": [...]\n}\n```\n\n### Otomatik Yedeklemeler\n\nCron ile günlük yedeklemeleri zamanlayın:\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> Cron uç noktası yanıtı alır ama saklamaz. Gerçek yedeklemeler için cron'u yanıtı kaydeden kendi yedekleme sunucunuza yönlendirin.\n\n### Daha İyisi: Harici Yedekleme Betiği\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\ncrontab'a ekleyin:\n\n```cron\n0 2 * * * /usr/local/bin/backup-synapse.sh\n```\n\n## Geri Yükleme\n\n### Aynı Mind'e Geri Yükleme\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### Yeni Mind'e Geri Yükleme\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 Geri Yükleme Betiği\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## Mind'ler Arası Taşıma\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## Diğer Verileri Yedekleme\n\nŞunları yedeklemeyi unutmayın:\n\n| Veri Tipi | Uç Nokta |\n|-----------|----------|\n| Bellekler | `GET /memory/mind-export` |\n| Görevler | `GET /mind/tasks` |\n| Betikler | `GET /scripts` |\n| Webhook'lar | `GET /webhooks` |\n| Cron işleri | `GET /cron` |\n| Değişkenler | `GET /var` |\n| Sohbet geçmişi | `GET /chat/history?limit=10000` |\n\n## Doğrulama\n\nGeri yüklemeden sonra doğrulayın:\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## En İyi Uygulamalar\n\n> [!TIP]\n> - **Günlük yedekleyin** — cron ile otomatikleştirin\n> - **Geri yüklemeleri test edin** — geri yükleyemediğiniz yedek işe yaramaz\n> - **Birden çok sürüm tutun** — en az 30 gün\n> - **Site dışında saklayın** — S3, Backblaze B2 vb.\n> - **Hassas yedekleri şifreleyin** — bellekler PII içerebilir\n> - **Geri yükleme sürecini belgeleyin** — ihtiyaç duyduğunuzda unutmuş olacaksınız\n\n## Sonraki Adımlar\n\n- [Memory API](/docs/api/memory)\n- [Cron & Zamanlayıcı](/docs/api/cron) — otomatik yedeklemeler için\n","content_html":"

Yedekleme & Geri Yükleme

\n

Synapse, bellek yedekleme, taşıma ve felaket kurtarma için tam dışa/içe aktarma sağlar. Bu rehber temel işlemleri kapsar.

\n

Dışa Aktarma

\n

Tam Mind Dışa Aktarımı

\n

Bir mind'deki tüm bellekleri JSON olarak dışa aktar:

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

Yanıt biçimi:

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

Artımlı Dışa Aktarma (Diff)

\n

Yalnızca bir zaman damgasından sonra değişen bellekleri dışa aktar:

\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

Yanıt:

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

Otomatik Yedeklemeler

\n

Cron ile günlük yedeklemeleri zamanlayın:

\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  }'
Cron uç noktası yanıtı alır ama saklamaz. Gerçek yedeklemeler için cron'u yanıtı kaydeden kendi yedekleme sunucunuza yönlendirin.

Daha İyisi: Harici Yedekleme Betiği

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

crontab'a ekleyin:

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

Geri Yükleme

\n

Aynı Mind'e Geri Yükleme

\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

Yeni Mind'e Geri Yükleme

\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 Geri Yükleme Betiği

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

Mind'ler Arası Taşıma

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

Diğer Verileri Yedekleme

\n

Şunları yedeklemeyi unutmayı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\n
Veri TipiUç Nokta
BelleklerGET /memory/mind-export
GörevlerGET /mind/tasks
BetiklerGET /scripts
Webhook'larGET /webhooks
Cron işleriGET /cron
DeğişkenlerGET /var
Sohbet geçmişiGET /chat/history?limit=10000
\n

Doğrulama

\n

Geri yüklemeden sonra doğrulayın:

\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

En İyi Uygulamalar

\n

Sonraki Adımlar

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