Documentation / Get started
Move from Railway
Import configuration, move data, and switch traffic safely.
Import configuration first
Open the Railway import flow in Upferry and connect the Railway account or token requested by the panel. Select the source project and review the proposed services, variables, images, and persistent data. Treat imported credentials as secrets.
Configuration import does not by itself prove that data has been copied, that a domain has moved, or that the application behaves correctly. Repository access, private image access, build versions, and external dependencies still need checking.
Test the new service
Deploy to the generated Upferry address. Check health, login, database access, uploads, webhooks, and the application's main workflow. Compare runtime and dependency versions with the source.
If the database remains at an external provider such as Supabase, keep its existing connection deliberately. There may be no database to copy from Railway. Conversely, a Railway volume or database requires an actual data transfer and verification. An empty new volume is not a migration.
Move writable data
Plan a short cutover window. Stop source writers before the final consistent copy, then restore and verify the target. Use pg_dump and pg_restore for PostgreSQL, engine-appropriate procedures for other databases, and a stopped-writer file copy for application volumes where suitable.
Do not run two polling bots with the same token or duplicate scheduled jobs against production. Imported services marked as waiting for cutover stay stopped until you explicitly switch them. Use staging credentials for parallel testing where possible.
Switch DNS and finish
- Keep the old hostname and source available while preparing the target.
- Add the custom hostname in Upferry and update its authoritative DNS record to the target shown in the panel.
- Wait for propagation and a valid HTTPS certificate. Test the real hostname and application behavior.
- Check background tasks and make a successful Upferry backup.
- Stop the old Railway service after traffic has moved and any old requests have drained.