How to run a Node.js, Python or Ruby application

For hosting customers · Updated 2026-10-29

On this page
  1. Before you start
  2. Steps
  3. Install dependencies
  4. Manage the application
  5. Good to know
  6. Common questions

Node.js / Python / Ruby runs your application as a background service and connects it to a website, either the whole site or one path such as /api. It is restarted automatically if it crashes and after a server reboot.

Before you start

  • Upload your code to its own folder in your home, for example ~/apps/myapp, with the File Manager, SFTP or Git deployment. Not inside public_html, mail, logs or tmp.
  • Your application must listen on 127.0.0.1 and on the port in the environment variable $PORT.

Steps

  1. Log in to the control panel (https://<server>:2083).
  2. Open Node.js / Python / Ruby in the menu (section Files).
  3. Under New application, choose the Runtime: Node.js, Python or Ruby (the installed version is shown).
  4. Website and path — choose the domain and the path: / for the whole website, /api for only that path.
  5. Application folder (in your home) — for example apps/myapp.
  6. Start command — leave it empty for the default:
    • Node.js: npm start
    • Python: .venv/bin/gunicorn --bind 127.0.0.1:$PORT app:app
    • Ruby: bundle exec rackup -o 127.0.0.1 -p $PORT
  7. Environment variables (one NAME=value per line) — for example NODE_ENV=production or DATABASE_URL=….
  8. Click Create.

Install dependencies

On the application's card, click npm install, pip install or bundle install. The output is shown on the page.

  • Node.js: uses package-lock.json (npm ci) or package.json, without development packages.
  • Python: creates a virtual environment in .venv and installs requirements.txt.
  • Ruby: installs the Gemfile into the app's own vendor/bundle, without development and test groups.

Then click Restart.

Manage the application

  • Start, Stop and Restart control the service. The badge shows running, stopped or failed.
  • Logs shows what your application printed. Check it first when the site shows an error.
  • Change the Start command or Environment variables and click Save and restart.
  • Remove application stops it and disconnects it from the website. Its files stay in your home folder.

Good to know

  • Each application gets up to 512 MB of memory and one processor core, within your plan's limits.
  • Up to 10 applications per account, and one application per website path.
  • PORT, HOST, PATH, HOME and USER are set by the panel and cannot be set as environment variables. Up to 50 variables.
  • The application can reach MySQL on localhost like a website. See database connection details.
  • An application at / takes over the whole website; static files in public_html are then not served for that domain.

Common questions

My app shows "failed". What is wrong?

Open Logs. Common causes: dependencies not installed (click npm install / pip install), a wrong Start command, or the app listening on another port than $PORT.

How do I run Django with gunicorn?

Install gunicorn in requirements.txt, click pip install, and use a start command such as .venv/bin/gunicorn --bind 127.0.0.1:$PORT myproject.wsgi.

Was this article helpful?

Still stuck?

Ask the AI about your exact situation — it answers from this knowledge base — or contact us.