Local-to-Cloud Migration

When to Migrate

Your SQLite database is growing beyond comfortable local limits (>10 GB)
You need multi-device access
You want automated backups and redundancy
You're moving from a laptop to a VPS or edge deployment

Migration Steps

1. Export Data

# Export memories as JSONL
docket export --store=sqlite --format=jsonl > memories.jsonl
 
# Export blobs
docket export --blob=filesystem --target=./blob-export

2. Prepare Cloud Config

Create config/profiles/hosted.yaml with your cloud provider settings.

3. Import Data

# Switch to hosted profile
export DOCKET_PROFILE=hosted
 
# Import memories
docket import --store=cloudflare-d1 --format=jsonl < memories.jsonl
 
# Import blobs
docket import --blob=r2 --source=./blob-export

4. Verify

docket doctor --profile=hosted
curl https://your-hosted-instance/health

5. Cutover

Update your clients to point to the hosted instance. Keep local as backup until verified.

Rollback

If something goes wrong:

export DOCKET_PROFILE=local
npm start

Your local data is untouched during migration.

Migration