How to run a Node.js, Python or Ruby application
On this page
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 insidepublic_html,mail,logsortmp. - Your application must listen on 127.0.0.1 and on the port in the environment variable
$PORT.
Steps
- Log in to the control panel (
https://<server>:2083). - Open Node.js / Python / Ruby in the menu (section Files).
- Under New application, choose the Runtime: Node.js, Python or Ruby (the installed version is shown).
- Website and path — choose the domain and the path:
/for the whole website,/apifor only that path. - Application folder (in your home) — for example
apps/myapp. - 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
- Node.js:
- Environment variables (one NAME=value per line) — for example
NODE_ENV=productionorDATABASE_URL=…. - 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) orpackage.json, without development packages. - Python: creates a virtual environment in
.venvand installsrequirements.txt. - Ruby: installs the
Gemfileinto the app's ownvendor/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,HOMEandUSERare set by the panel and cannot be set as environment variables. Up to 50 variables.- The application can reach MySQL on
localhostlike a website. See database connection details. - An application at
/takes over the whole website; static files inpublic_htmlare 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.
Thank you — this helps us improve the article.
Still stuck?
Ask the AI about your exact situation — it answers from this knowledge base — or contact us.
Related articles
- How to deploy a website from GitHub or GitLab with Git
Connect a GitHub, GitLab or Bitbucket repository, add the deploy key for private repos, deploy with a button or a push webhook, and run composer after deploy.
- How to add an SSH key and connect to your account with SSH
Create an ed25519 key, add the public key in SSH Access, and sign in with ssh or sftp. Explains SFTP-only plans and which key types are accepted.
- Resource Usage explained: disk, bandwidth, CPU and memory limits
Read the Resource Usage page: disk space by type, monthly bandwidth, file count, and the processor, memory and process limits that can slow a website.
- MySQL connection details: host, port, socket and examples
The database host (localhost), port 3306, socket path, name and user format to connect WordPress, PHP, Laravel, Node.js or Python to MySQL, with examples.