Migrate from Fly.io

This guide walks you through migrating your application from Fly.io to Zeabur. Whether you’re running a Docker-based app, a web service, or a full-stack application with a Postgres database, Zeabur can handle it with minimal configuration changes.

Before You Begin

• A Zeabur account.
• Your application source code in a Git repository (GitHub).
• Access to your Fly.io dashboard and CLI (flyctl).

Step 1: Review Your Fly.io Configuration

Open your project’s fly.toml file. This contains the settings you’ll need to recreate on Zeabur:

# fly.toml — example
app = "my-app"
 
[env]
  NODE_ENV = "production"
  PORT = "8080"
 
[http_service]
  internal_port = 8080
 
[[vm]]
  memory = "512mb"
  cpu_kind = "shared"

Take note of:

• Environment variables under [env] and any secrets set via fly secrets list.
• Internal port your app listens on.
• Volumes if you have [mounts] configured.

Step 2: Export Your Fly.io Secrets

List all secrets so you can transfer them to Zeabur:

fly secrets list -a my-app

This shows the secret names (values are hidden). For each secret, you’ll need to retrieve or regenerate the value from the original source (e.g., your database provider, API dashboard).

Step 3: Connect Your Git Repository to Zeabur

1. Log in to the Zeabur dashboard.
2. Create a new project and select a dedicated server (or purchase a new one).
3. Click Add Service → Git and connect your GitHub account.
4. Select the repository containing your application code.

Zeabur automatically detects your project’s language and framework — no fly.toml or Dockerfile required in most cases.

Step 4: Configure Environment Variables

1. Click on your newly created service in the Zeabur dashboard.
2. Go to the Variables tab.
3. Add each environment variable and secret from your Fly.io app.

You do not need to set PORT — Zeabur automatically assigns and injects the port for your service.

Step 5: Set Up Persistent Storage (If Needed)

If your Fly.io app uses volumes ([mounts] in fly.toml), you’ll need to create a volume on Zeabur:

1. In your service settings, go to the Volumes tab.
2. Click Add Volume and specify the mount path (e.g., /data).
3. Zeabur provisions persistent storage that survives redeployments.

Step 6: Migrate Your Database

If you’re running Fly.io Postgres:

1. Export your data from Fly.io Postgres:

   fly proxy 15432:5432 -a my-app-db &
   pg_dump -h localhost -p 15432 -U postgres -d my_database > backup.sql

2. Create a database on Zeabur: click Add Service → Database → PostgreSQL.

3. Import your data: use the connection string from Zeabur’s PostgreSQL service:

   psql "your-zeabur-postgres-connection-string" < backup.sql

4. Update your app’s database URL: in the Zeabur Variables tab, set DATABASE_URL to the Zeabur PostgreSQL connection string. You can use Zeabur’s built-in variable reference ${POSTGRES_URI} to automatically inject the connection string.

Step 7: Set Up Custom Domains

1. In the Zeabur dashboard, click your service and go to the Networking tab.
2. Click Generate Domain for a free .zeabur.app subdomain, or click Custom Domain to add your own.
3. If using a custom domain, update your DNS records:
   • Remove the old Fly.io CNAME or A records.
   • Add a CNAME record pointing to the Zeabur-provided target.

Key Differences: Fly.io vs Zeabur

That’s it. Your Fly.io application is now running on Zeabur. If you run into any issues, reach out on our community forum.