Move from Replit to Codex, step by step

Your setup

Tell us what your app uses and where you want it to run.

Preparation

Get GitHub, Node.js and Codex ready, plus anything else your app needs.

Migration

Follow 8 to 18 steps, depending on your app. Each shows you what to do and how to check it worked.

• Push the project to GitHubConnect the Replit app to GitHub in the Git pane and push it to a private repository.
• Get your code onto your computerCopy the private repository to a folder on your computer.
• Open the project in the Codex appAdd the project folder to the Codex app and start a thread in it.
• Copy your secretsCopy the keys from Replit Secrets into a .env file on your computer.
• Run your app on your computerInstall what the app needs and start it with the keys from .env.
• Open the project in CodexStart Codex in the project folder in a terminal.
• Check what your app usesFind out if the app uses a database, Replit Auth and App Storage.
• Test logins and uploads on ReplitReplit Auth and App Storage work only on Replit, so you test them in the Replit preview.
• Back up your databaseMake a copy of the production database before you change anything.
• Set up your own Supabase projectCreate a Supabase project for the database, the logins and the files.
• Move your databaseRestore the backup into your Supabase project and point the app at it.
• Switch the login to SupabaseCodex changes the login from Replit Auth to Supabase Auth.
• Copy uploaded filesCopy the files from App Storage to Supabase Storage and change the upload code.
• Remove the Replit partsCodex removes what only works on Replit and checks that the app builds.
• Tell Codex about your projectCodex writes an AGENTS.md, a short note it reads at the start of every session.
• Prepare the server for VercelCodex changes the Express server so Vercel can run it as functions.
• Send your changes to GitHubPush your changes so the new host builds the latest code.
• Deploy to VercelImport the GitHub repository in Vercel, add the values from .env and deploy it.
• Run your app on your own serverCodex deploys the app on your VPS through PanelAlpha Engine, with HTTPS.
• Deploy every push automaticallyAdd a GitHub webhook so every push deploys the app on your VPS.
• Make logins work on your new addressAdd the new address to the login settings in Supabase.
• Point your domain to the new hostChange your domain's DNS records so the domain opens the new host.
• Keep your code in sync with ReplitPull before you work and push when you finish, so Replit and Codex stay in sync.
• Publish your changes from ReplitPull your changes into Replit and publish the app again.
• Turn off the app on ReplitTurn off the old deployment on Replit once the new app works.

Final check

Test everything before switching. Your Replit app stays online until you're ready.