metaplay database import-archive [ENVIRONMENT] [INPUT_FILE] [flags]

Import database archive from a file created by 'database export-archive' into the target environment.

WARNING: This is a destructive operation and will PERMANENTLY OVERWRITE ALL DATA in the target environment's database!

Safety protections:

• By default, requires manual confirmation before proceeding
• Use --yes to skip overwrite confirmation (intended for automation)
• Use --force to bypass game server deployment checks (can put the database in an inconsistent state!)
• Use --confirm-production when importing to production environments

For multi-shard environments, each shard archive will be restored to the corresponding shard in the target environment (shard_0.sql → shard 0, etc.). The target environment must have the same number of shards as the archive, or otherwise the command will fail.

Expected arguments:

• ENVIRONMENT -- Target environment name or id, eg, 'lovely-wombats-build-nimbly'.
• INPUT_FILE -- Input file path containing database archive (eg, 'database-archive.mdb').

Related commands:

• 'metaplay database export-archive' exports a database archive.

Examples

# Import database archive to 'nimbly' environment (asks for manual confirmation)
metaplay database import-archive nimbly archive.mdb
# Auto-accept import without confirmation prompt
metaplay database import-archive nimbly archive.mdb --yes
# Import to production environment (requires additional confirmation)
metaplay database import-archive production archive.mdb --yes --confirm-production

Flags

• --confirm-production: Required flag when importing to production environments
• --force: Proceed with import even if a game server is deployed (DANGEROUS!)
• --yes: Skip confirmation prompt and proceed with import

Inherited Flags

• --color <string>: Should the output be colored (yes/no/auto)? [env: METAPLAYCLI_COLOR] (default: auto)
• --project <string>: Path to the to project directory (where metaplay-project.yaml is located)
• --skip-version-check: Skip the check for a new CLI version being available
• --verbose: Enable verbose logging, useful for troubleshooting [env: METAPLAYCLI_VERBOSE]