Backup & Restore¶

Protect your print history with database backups and restore when needed.

Overview¶

Bambuddy's backup system:

• Full database backup - All your data
• Selective restore - Choose what to restore
• User settings included - Preferences preserved
• Archives included - Print history saved

Creating a Backup¶

Manual Backup¶

1. Go to Settings > Backup
2. Click Create Backup
3. Wait for backup to complete
4. Download the backup file

Backup Contents¶

What's NOT Included¶

Backup File¶

Format¶

Backup files are SQLite database exports:

bambuddy_backup_2024-01-15_143022.db

File Size¶

Typical sizes:

• 100 prints: ~5-10 MB
• 1,000 prints: ~50-100 MB
• 10,000 prints: ~500 MB - 1 GB

Size depends on metadata stored per print.

Restoring from Backup¶

Full Restore¶

Restore everything from a backup:

1. Go to Settings > Backup
2. Click Restore from Backup
3. Select your backup file
4. Click Full Restore
5. Confirm (this overwrites current data)
6. Wait for restore to complete
7. Restart Bambuddy

Selective Restore¶

Choose specific data to restore:

1. Click Restore from Backup
2. Select backup file
3. Choose Selective Restore
4. Check items to restore:
5. Archives
6. Printers
7. Settings
8. Notifications
9. Projects
10. Click Restore Selected

Merge vs Replace¶

Scheduled Backups¶

Automatic Backups¶

Configure automatic backups:

1. Go to Settings > Backup
2. Enable Automatic Backups
3. Set schedule:
4. Daily
5. Weekly
6. Monthly
7. Set retention (how many to keep)
8. Optionally set backup location

Backup Retention¶

Automatic cleanup of old backups:

Manual Database Access¶

Location¶

The database is stored at:

/path/to/bambuddy/bambuddy.db

Direct Backup¶

Copy the database file directly:

cp bambuddy.db bambuddy_backup_$(date +%Y%m%d).db

SQLite Tools¶

Use SQLite tools for advanced operations:

# Dump to SQL
sqlite3 bambuddy.db .dump > backup.sql

# Restore from SQL
sqlite3 new.db < backup.sql

Downloading Archives¶

3MF files aren't in database backups. Download separately:

Individual Download¶

1. Open an archive
2. Click Download 3MF

Bulk Export¶

1. Go to Archives
2. Click Export
3. Select Include 3MF files
4. Download the archive

Recovery Scenarios¶

Lost Database¶

If database is corrupted or deleted:

1. Stop Bambuddy
2. Remove corrupted bambuddy.db
3. Start Bambuddy (creates fresh database)
4. Go to Settings > Backup
5. Restore from your backup

New Installation¶

Moving to a new server:

1. Install Bambuddy on new server
2. Copy backup file to new server
3. Go to Settings > Backup
4. Full restore from backup

Data Migration¶

Moving between versions:

1. Create backup on old version
2. Upgrade Bambuddy
3. If needed, restore from backup

Best Practices¶

Backup Schedule¶

Storage¶

• Keep backups off the Bambuddy server
• Use cloud storage (Dropbox, Google Drive, etc.)
• Keep multiple versions

Testing¶

• Periodically test restoring
• Verify backup integrity
• Document your backup process

Tips¶