How to run a Node or Python app on your hosting

From a directory of code to a running app behind your website: installing a runtime, the start command, the port and attaching a website in the panel.

Updated: Markdown version (for agents)

What you need

  • A hosting service with the beta on: Hosting → your service → Apps → Switch the beta on.
  • The app’s code in your home directory, uploaded by FTP or SFTP, or with git clone in the console.
  • About 1.1 GB of free space for a Next.js project with its runtime and package cache.

Steps

  1. Open Hosting → your service → Console.

  2. Pick the runtime version and install the dependencies in the project’s directory. For Node:

    cd my-app
    mise use node@24
    npm install
    npm run build
    

    For Python:

    cd my-app
    uv python install 3.13
    uv sync
    
  3. Open Apps → New app.

  4. In Name, type for example shop. You cannot change this name later.

  5. In Directory, type the path relative to your home directory, for example my-app.

  6. In Start command, type a command that listens on 0.0.0.0 and the port from the PORT variable:

    • Next.js: npm run start -- -H 0.0.0.0 -p $PORT
    • FastAPI with uv: uv run uvicorn main:app --host 0.0.0.0 --port $PORT
    • Bun: bun run server.js
  7. In Port, type the port number, for example 3000.

  8. Click Add and start.

  9. On the app’s page, in the Website section, choose a website and click Attach.

How to check it works

The app’s state is Running, and your website shows the app. The Console section on the app’s page shows its output live.

When it does not work

  • The website says the app is not answering: the app listens on 127.0.0.1 or on a different port than the one you gave. Fix the start command.
  • The app keeps restarting: read the error in the Console. Usually a dependency or the built code is missing.
  • An install fails with a write error: the disk is full. Check the space on the service’s page.
  • create-next-app refuses to create the project: the directory is not empty, for example it already has mise.toml. Create the project in a subdirectory.

← All articles