Migration from Replit to CreateOS

Use this guide when your app was built in Replit and you want to run it on CreateOS with normal deployment controls, environment variables, domains, logs, and scaling.

What changes

Step by step

1. Open the Replit project and confirm it runs successfully.
2. Export the code:
   • Preferred: push or sync the project to GitHub.
   • Alternative: download the project as a ZIP and use CreateOS file upload.
3. Check the .replit file, package.json, or framework config to identify:
   • Install command
   • Build command
   • Start command
   • Runtime port
4. Move secrets from Replit Secrets into CreateOS environment variables.
5. If the app starts a server, make sure it binds to 0.0.0.0 and reads the port from an environment variable when possible.
6. Sign into createos.sh/app.
7. Click Deploy.
8. Choose Import GitHub Repository or Deploy using File Upload.
9. Select Build with AI if you want CreateOS to detect the framework and commands, or choose Manual if you already know the exact commands.
10. Add environment variables, confirm the port, and deploy.
11. After deployment, open the live URL and verify login, API routes, background work, and any external services.

Replit-specific checks

• If the app uses Replit DB, migrate that data before switching traffic.
• If files are written locally at runtime, move them to object storage or another persistent service.
• If the project depends on packages installed through the Replit environment, add them to the project manifest before deploying.
• If the app has a custom domain on Replit, update DNS only after the CreateOS deployment is verified.

Cutover

1. Deploy the app on CreateOS.
2. Test the CreateOS URL directly.
3. Add production environment variables.
4. Point the custom domain to CreateOS.
5. Keep the Replit deployment available until DNS has propagated and the CreateOS deployment is stable.