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 clonein the console. - About 1.1 GB of free space for a Next.js project with its runtime and package cache.
Steps
-
Open Hosting → your service → Console.
-
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 buildFor Python:
cd my-app uv python install 3.13 uv sync -
Open Apps → New app.
-
In Name, type for example
shop. You cannot change this name later. -
In Directory, type the path relative to your home directory, for example
my-app. -
In Start command, type a command that listens on
0.0.0.0and the port from thePORTvariable:- 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
- Next.js:
-
In Port, type the port number, for example
3000. -
Click Add and start.
-
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.1or 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-apprefuses to create the project: the directory is not empty, for example it already hasmise.toml. Create the project in a subdirectory.
