Wodby CLI
Manual /wodby migrate wodby1

wodby migrate wodby1 instance

Preview, apply, or verify a Wodby 1 instance migration

Migrate exactly one Wodby 1 app instance. The default command is a read-only preview. Add --apply to create the target and import data, then test the target using its technical route. Change DNS only after testing succeeds, and rerun the same command with --verify to validate the completed migration. The migration exports only the selected instance and its parent app metadata, then creates a new Wodby 2 app containing that instance. Before --apply, enable maintenance mode from [App instance] > Stack > Settings and create a fresh backup for the selected instance. Use --force only to intentionally import an existing backup and exclude later writes. Apply is resumable and stores its plan and state in the system temporary directory. When state exists, the same --apply command preserves the saved plan and continues completed work. --restart replaces it only when state proves that no target mutation occurred.

Usage

wodby migrate wodby1 instance SOURCE_INSTANCE_UUID [flags]

Examples

export WODBY1_SOURCE_TOKEN=...
  export WODBY_API_KEY=...

  wodby migrate wodby1 instance INSTANCE_UUID --target-stack-id STACK_ID [target and mapping options]
  wodby migrate wodby1 instance INSTANCE_UUID --target-stack-id STACK_ID [same options] --apply
  wodby migrate wodby1 instance INSTANCE_UUID --target-stack-id STACK_ID [same options] --verify

Options

Flag Description Default
--apply Create the target and import data using the displayed plan false
--force Import an existing backup without maintenance mode or an age limit; excludes later writes and does not bypass other blockers false
-h, --help help for instance false
--max-backup-age duration Maximum backup age accepted by --apply 1h0m0s
-o, --output string Output format: text or json text
--poll-interval duration Target operation polling interval 2s
--restart Start a new applied plan only when saved state proves that no target mutation occurred (requires --apply) false
--retry-ambiguous string Retry exactly one inspected ambiguous operation ID -
--skip-code Intentionally omit repository/build-source migration false
--skip-data Intentionally omit database and files imports false
--source-base-url string Wodby 1 API base URL https://api.wodby.com
--source-token string Wodby 1 API token (defaults to WODBY1_SOURCE_TOKEN) -
--state-file string Secure resume-state path (defaults to the system temporary directory) -
--target-ci-integration-id int Wodby 2 CI integration ID (defaults to 0 for built-in Wodby CI) 0
--target-cluster string Wodby 2 cluster ID or exact name -
--target-code-service string Target connect-build service name when the stack has more than one -
--target-env-map stringArray Source-to-target environment mapping (SOURCE=TARGET) []
--target-git-integration-id int Wodby 2 Git integration ID used to resolve the source repository 0
--target-git-ref string Git branch, tag, or commit to build (defaults to the source ref) -
--target-git-ref-type string Git ref type: branch, tag, or commit -
--target-import-map stringArray Backup-to-import mapping ([APP/][INSTANCE/]COMPONENT=SERVICE:IMPORT) []
--target-project string Wodby 2 project ID or exact name (defaults to a project-owned cluster's owner; otherwise organization-owned) -
--target-repository-name string Exact repository name in the selected Wodby 2 Git integration (defaults to the name derived from the Wodby 1 repository URL) -
--target-service-map stringArray Source-to-target service mapping ([APP/][INSTANCE/]SOURCE=TARGET) []
--target-stack-id int Wodby 2 target stack ID (required unless every source stack has a scoped mapping) 0
--target-stack-map stringArray Source-to-target stack ID mapping ([APP/][INSTANCE/]SOURCE=TARGET_STACK_ID) []
--verify Verify the applied migration after testing and DNS cutover false
--wait-timeout duration Timeout for each target operation 30m0s

Options inherited from parent commands

Flag Description Default
--access-token string Access token -
--api-base-url string Public REST API base URL https://apiv2.wodby.com/v1
--api-key string API key -
--ci-config-path string Path to CI config /tmp/.wodby-ci.json
--verbose Verbose output false

See also

wodby migrate wodby1