Migrating to Atlasflow
View as MarkdownMove an existing app from another platform to Atlasflow.
Migrating to Atlasflow is mostly about making sure your app runs as a container that listens on the right port. Once that's true, deploying is the same as any other Atlasflow project.
The universal checklist
No matter where you're coming from, every migration comes down to the same few steps:
- Containerize: add a Dockerfile, or rely on automatic builds if your stack is supported.
- Listen on port 3000: bind to
0.0.0.0:3000. See Container requirements. - Respond on
GET /: the health check expects a 2xx response. - Move your config to environment variables: split values into build and runtime scopes.
- Connect the repository: create an Atlasflow project from your GitHub repo.
- Point your domain: add and verify a custom domain, then cut over DNS.
Platform guides
Migrating from Railway
Move a Railway service to Atlasflow.
Migrating from Render
Move a Render web service to Atlasflow.
Migrating from Heroku
Move a Heroku app to Atlasflow.
Migrating from Fly.io
Move a Fly.io app to Atlasflow.
Migrating from Vercel
Move a containerized or server-rendered app from Vercel to Atlasflow.
What's different about Atlasflow
| Topic | Atlasflow approach |
|---|---|
| Source | GitHub App; deploys on push to your default branch. |
| Builds | Dockerfile, or Railpack auto-detection. |
| Port | Fixed at 3000; bind to 0.0.0.0. |
| Runtime | One container per deployment, isolated on a microVM. |
| Config | Project settings plus environment variables; no platform-specific config file. |
| Domains | Verified via DNS; TLS is automatic. See Custom domains. |
| Pricing | Per-second usage billing with included credits. |
Cutting over safely
Deploy on Atlasflow and test against the preview URL before changing DNS. When you're confident, point your domain at Atlasflow and verify it. Keep the old platform running until traffic has fully moved and you've confirmed everything works.
Next steps
Pick your current platform from the list above, or start with Getting started if you're ready to create a project.