Hubfly spaceDocs
Console

Move to another region

A region move copies a Cell project's containers, writable root filesystems, volumes, images and routes. A short freeze lets Hubfly space copy the last changes and verify the target before switching over.

Supported projects

Region migration supports Cell projects. Managed databases, Realtime, Storage, Boxes and Mail need their own migration procedures. Account transfers cover all project types.

Review the move

Open Project settings → Danger zone → Move to another region. Choose an eligible region and review the fee, freeze ranges, data sizes, new hostnames, DNS changes and preparation checklist. Measure bandwidth to refine the estimate. Hard-coded old addresses in environment variables appear as warnings; secret values are never shown in this report.

Choose a freeze window

A warm move copies while your app is running, then freezes it for the final delta. A cold move stops first and copies everything. Pick a local window or start now. Set a maximum warm freeze between one minute and 24 hours. If the estimate stays above the limit, the app keeps running and you choose whether to keep copying, freeze now or cancel. Type the project name to confirm.

Progress and verification

The project page shows copied bytes, copy passes, resource states, the current step, freeze time and automatic verification. Hubfly space independently compares data Merkle roots, image digests, configuration and runtime/endpoint checks before cutover. Compute during the freeze and the temporary target copy are not billed twice. Completion and action-required emails keep you informed.

DNS and connections

Follow the exact per-record DNS plan. Custom domains need CNAME or A record changes. The live checker reports whether public DNS has switched and whether certificates are ready; caches can take time. Update TCP connection strings, registry push destinations and external IP allowlists too. Old endpoints forward temporarily until the displayed bridge deadline.

Cancel or move back

You can cancel before the freeze; the partial target is removed and the fee refunded. Verification failure before cutover restores the source automatically. A failure after cutover needs operator recovery. During retention, Move back copies changes from the current region into the retained source. Default retention is seven days; use the deadline on the project page. Download a signed attestation with copy roots and timestamps after completion.

Several projects

Customer batches move 2–20 projects of one account with concurrency two. Track them at /migrations/batches/BATCH_ID. Canceling a batch stops cancelable members; moves already frozen finish safely. An empty or hibernated project can use a free metadata rehome.

CLI and SDK

bash
hubfly project migrate my-app --region TARGET --mode warm --max-freeze 10m --wait
hubfly project migration status my-app --json
hubfly project migration continue keep-syncing my-app --yes
hubfly project migration dns my-app
hubfly project migration attestation my-app --json
hubfly project history my-app --json

Migration writes accept unrestricted personal access tokens. Scoped or project-pinned tokens, machine keys and impersonation are refused. TypeScript uses client.projects.migration and client.migrationBatches. Go uses client.ProjectMigrations and client.MigrationBatches. See CLI project commands, TypeScript SDK and Go SDK.

Something unclear or out of date? Emailsupport@hubfly.spaceBack to top