Move a Replit app to Salus

Check how the app starts, and on which port

Replit starts your app with the run command in .replit, and sends traffic to the port under [[ports]], usually through a PORT variable it sets. Salus doesn’t set PORT, so an app written as process.env.PORT || 3000 listens on 3000 on Salus. Note that port; you’ll give it to Salus in step 3.

• Node.js: make sure package.json has a start script (for example "start": "node index.js"). Salus runs it.
• Python: add a Procfile at the root of the repository with the command that starts your server, on a fixed port. For FastAPI:

web: uvicorn main:app --host 0.0.0.0 --port 8080

Keep requirements.txt up to date; Salus installs from it. Replit’s .replit and replit.nix files are ignored.

Move the secrets

Everything in Replit’s Secrets pane becomes an environment variable on Salus. Add each one to the project, marked as a secret, and as a runtime variable unless the build needs it. See Environment Variables.

Create the project and deploy

In the console, create a project from the repository as a server-side application and set the release configuration’s port to the one from step 1. See the Quickstart.

Or ask your coding agent, once it’s connected to Salus:

Deploy this repository to Salus in the Production environment.
It listens on port 3000. Watch the pipeline and give me the URL.

The pipeline builds, tests, scans and deploys the app, and the deployment gets a URL when it’s exposed to the public.

Move the database

If the app used Replit’s PostgreSQL, create a database on Salus in the same region as the environment and link it to the project. Linking injects the connection details as variables named after the database, such as SALUS_DATABASE_ORDERS_DB_CONNECTION_STRING. Point the app at that variable where it used to read DATABASE_URL:

const connectionString =
  process.env.SALUS_DATABASE_ORDERS_DB_CONNECTION_STRING ?? process.env.DATABASE_URL;

The data doesn’t move with the app. Export it from Replit with pg_dump and load it into the new database.

Replit’s key-value Replit DB has no equivalent on Salus; store that data in a table in the PostgreSQL database instead.