---
title: "How to run a Node or Python app on your hosting | Hosteam"
description: "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."
canonical_url: "https://hosteam.pl/en/kb/uruchom-aplikacje-node-python"
---

> Index of every page on this site: [llms.txt](https://hosteam.pl/llms.txt)

# **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: 14 November 2026 [Markdown version (for agents)](https://hosteam.pl/en/kb/uruchom-aplikacje-node-python.md)

## 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**](https://hosteam.pl/en/kb)
