gb restore-db

Restore a local MongoDB backup to your Genbox environment.

Synopsis


gb restore-db [name] [options]

Description

Uploads and restores a local MongoDB dump to your Genbox. Useful for migrating local development data to the cloud.

Arguments

Argument	Description
`name`	Optional. Target environment name.

Options

Option	Description
`--path <dir>`	Path to mongodump directory
`--drop`	Drop existing data before restore
`--db <name>`	Target database name
`-y, --yes`	Skip confirmation

Examples

Basic Restore


gb restore-db feature-auth

From Specific Path


gb restore-db --path ./backup/mongodb-dump

Drop and Restore


gb restore-db --drop

Specify Database


gb restore-db --path ./dump --db myapp_dev

Creating Local Backups

First, create a local MongoDB dump:


# Dump entire database
mongodump --db myapp --out ./backup
 
# Dump specific collections
mongodump --db myapp --collection users --out ./backup
 
# Dump with query
mongodump --db myapp --collection orders --query '{"status":"active"}' --out ./backup

Restore Process

Compress: Local dump is compressed
Upload: Transferred to Genbox via SSH
Restore: mongorestore runs on Genbox
Verify: Collection counts confirmed

Progress Output


Restoring database to 'feature-auth'...

  Compressing local backup...
  Uploading (23.4 MB)... done
  Restoring...

    ✓ users         1,234 documents
    ✓ products      5,678 documents
    ✓ orders        3,456 documents

  Restore complete!

Notes

Requires local mongodump directory
Existing data is preserved unless --drop
Large backups may take time to upload
Uses mongorestore on the Genbox