Documentation

💾Enterprise Backup System

Comprehensive backup and disaster recovery solutions for your AI configurations, data, and system state

← Back to Documentation

Never Lose Your AI Setup Again

Enterprise-grade backup and recovery system that protects your AI configurations, conversation history, model rankings, and MCP settings with automated schedules, cloud sync, and one-click restoration.

Backup System Status

System Healthy - 5 Backups Active
5
Total Backups
0.01GB
Total Size
1.8
Days Average
99.9%
Integrity Rate

🔄 Multi-Type Backups

Daily, weekly, monthly, emergency, and manual backups

☁️ Cloud Sync Ready

OneDrive, iCloud, Dropbox, Google Drive integration

🛡️ Integrity Verified

Checksums, compression, and metadata validation

💻 Terminal/CLI Commands

Backup Creation

# Create full backup with custom label
hive backup create full "my-custom-backup"

# Create emergency backup
hive backup create emergency "pre-update-backup"

# Output:
💾 Creating full backup with label: my-custom-backup...
✅ Backup created successfully!
📁 Location: ~/.hive-ai/backups/manual/hive-ai-knowledge-my-custom-backup-2025-06-21T01-00-27-663Z.db
📊 Size: 2.49 MB | 📈 Conversations: 44 | ⏱️ Duration: 22ms

Backup Management & Health

# List all available backups by type
hive backup list
hive backup list daily
hive backup list emergency

# Comprehensive health check
hive backup health

# Sample Output:
🏥 Backup System Health Check...
📊 Total Backups: 5 | Total Size: 0.01 GB
📅 Latest: 6/20/2025, 9:01:03 PM | ⏱️ Frequency: 1.8 days
✅ Backup system is healthy!

Cloud Storage Configuration

# Configure backup storage locations
hive backup locations

# Shows all configured backup destinations:
1. ✅ Default Local (PRIMARY)
Path: ~/.hive-ai/backups
2. ✅ OneDrive Sync
Path: ~/OneDrive/hive-ai-backups
3. ✅ iCloud Sync
Path: ~/Library/Mobile Documents/com~apple~CloudDocs/hive-ai-backups

Restoration & Recovery

# Restore from specific backup file
hive backup restore /path/to/backup.db

# Emergency disaster recovery
hive backup emergency-restore

# Restoration includes:
• All conversation history and knowledge
• Model rankings and discovery data
• MCP server configurations
• User profiles and preferences

🔧 IDE Integration (Claude Code, Cursor, Windsurf)

💡 MCP Integration: All backup commands work seamlessly through MCP tools. Your IDE can execute backup operations using the Hive AI CLI through the MCP server.

Create Backup via MCP

// Claude Code, Cursor, Windsurf
Run: hive backup create full
"project-snapshot"

Create backup with custom label through IDE

Check Backup Status

// IDE Terminal Command
hive backup health
hive backup list

Monitor backup system from IDE

Cloud Sync Setup

// Configure sync locations
hive backup locations

View and configure cloud storage sync

Emergency Recovery

// Disaster recovery
hive backup emergency-restore

Quick recovery from latest backup

🔗 Seamless MCP Integration

  • Zero Configuration: Backup commands work automatically through MCP server
  • IDE Terminal: Execute backup operations directly from your IDE's terminal
  • Real-time Updates: See backup progress and status in your development environment
  • Cross-Platform: Works identically across Claude Code, Cursor, VS Code, and Windsurf

🏗️ Backup Architecture & Data Integrity

📁 Directory Structure

~/.hive-ai/backups/
├── daily/ # Daily rotation
├── weekly/ # Weekly retention
├── monthly/ # Long-term storage
├── emergency/ # Pre-operation backups
├── manual/ # User-initiated
└── mcp-configs/ # MCP settings

🔍 Metadata Tracking

{
"timestamp": "2025-06-21T01:00:27.667Z",
"type": "full",
"size_bytes": 2609152,
"conversation_count": 44,
"checksum": "94d08275b35cab...",
"integrity_verified": true,
"mcp_config_included": true
}

🔐 Data Protection Features

  • Compression: Efficient .gz compression
  • Checksums: SHA-256 integrity verification
  • Atomic Operations: All-or-nothing backup creation
  • Version Tracking: Schema version compatibility
  • Performance Metrics: Duration and size tracking
  • Recovery Validation: Pre-restore integrity checks
  • Multi-Location Sync: Cloud storage integration
  • Privacy First: 100% local storage (no cloud uploads)
  • MCP Configuration: Complete server state backup

⚡ Performance Metrics

22ms
Backup Speed
480KB
Compressed Size
5.2x
Compression Ratio
100%
Success Rate

🛡️ Enterprise-Grade Data Protection

Never lose your AI conversations, model rankings, or custom configurations again. Our backup system protects 44+ conversations, 320+ model rankings, and all your personalized AI settings with military-grade reliability.

# Test your backup system right now
hive backup health
hive backup create full "my-first-backup"
hive backup locations
✅ Instant Setup
Works out of the box
☁️ Cloud Sync
OneDrive, iCloud, Dropbox
🔒 100% Private
Local storage only
Start free trial