OpenHuman Backup & Restore — Don't Lose Your Memory Tree

Your OpenHuman Memory Tree stores months or years of AI context. Losing it means starting from scratch. This guide shows you how to back up and restore everything.

What to Back Up

• Memory Tree — `~/.openhuman/memory_tree/` (most important)
• Configuration — `~/.openhuman/config.toml`
• Logs — `~/.openhuman/logs/` (optional)

Manual Backup

# Backup Memory Tree
cp -r ~/.openhuman/memory_tree ~/backups/memory_tree_$(date +%Y%m%d)

# Backup config
cp ~/.openhuman/config.toml ~/backups/config_$(date +%Y%m%d).toml

# Full backup
tar czf ~/backups/openhuman_full_$(date +%Y%m%d).tar.gz ~/.openhuman/

Automated Backup

Set up a cron job (Linux/macOS):

# Daily backup at 3 AM
0 3 * * * tar czf $HOME/backups/openhuman_$(date +\%Y\%m\%d).tar.gz $HOME/.openhuman/

# Keep only last 7 days
0 3 * * * find $HOME/backups/ -name "openhuman_*" -mtime +7 -delete

Restore from Backup

# Stop OpenHuman first
# Then restore:
tar xzf ~/backups/openhuman_20260525.tar.gz -C ~/

# Or restore just the Memory Tree:
cp -r ~/backups/memory_tree_20260525 ~/.openhuman/memory_tree

Migrating to a New Computer

1. Install OpenHuman on the new machine
2. Copy the full backup archive
3. Extract: tar xzf openhuman_full_20260525.tar.gz -C ~/
4. Re-authorize any OAuth integrations
5. Restart OpenHuman

Don't Forget

• API keys need to be re-entered if they weren't exported
• OAuth tokens expire — expect to re-authorize integrations
• Back up to a different drive or cloud storage for redundancy
• Test your restore process periodically