Data Migration (migrate)

Direct server-to-server migration of workspaces, projects, environments, and secrets between instances.

Direct Server-to-Server Migration

The recommended migration flow transfers data directly between server instances without touching disk files.

1Generate Token on Source Server

# Point CLI to source server and authenticate
agentsecrets server set https://api.agentsecrets.tech
agentsecrets login

# Generate 30-minute single-use migration token
agentsecrets migrate token

2Tender Token on Destination Server

# Point CLI to destination server and authenticate
agentsecrets server set https://api.agentsecrets.yourcompany.com
agentsecrets login

# Trigger server-to-server migration
agentsecrets migrate --from https://api.agentsecrets.tech --token <MIGRATION_TOKEN>

Offline / Airgapped Bundle Commands

For airgapped environments where the destination server cannot reach the source server:

agentsecrets migrate export

Exports encrypted workspace data into a local JSON bundle.

agentsecrets migrate export --output bundle.json

agentsecrets migrate import

Imports a local JSON bundle into the active server.

agentsecrets migrate import bundle.json

For complete architectural details, see the Server Data Migration Guide.