Everyone

Node.js on Opterius

Overview of Node.js support in Opterius Panel — PM2 process management and Nginx proxying.

Last updated 1775606400

Opterius Panel lets you deploy and manage Node.js applications alongside your PHP sites. Node.js apps are managed by PM2, a production-grade process manager that keeps apps running and restarts them automatically on server reboot.

How It Works

  1. You upload your Node.js app files to the server (via FTP, SSH, or the File Manager)
  2. You register the app in the panel — give it a name, startup command, and port
  3. The panel starts it with PM2 under your hosting account user
  4. Nginx is configured to proxy your domain to the app's port over HTTPS
Browser → Nginx (443) → proxy_pass → Node.js app (port 3000)

Your app only needs to listen on a local port — Nginx handles SSL termination and forwards requests.

What's Installed

Component Purpose
Node.js The runtime
npm Package manager
PM2 Process manager — keeps apps running, handles restarts

The installed versions are shown at the top of the Node.js page.

App Lifecycle

  • Running — PM2 is managing the process, it's accepting requests
  • Stopped — process is registered in PM2 but not running
  • Error — the process crashed; check the logs

PM2 automatically restarts an app if it crashes. If the server reboots, PM2 restores all running apps from its saved process list.

Limitations

  • One port per app. Ports must be in the range 1024–65535 and not conflict with other apps or services
  • Apps run as the hosting account user — they cannot escalate privileges
  • No package manager isolation per app — all apps on an account share the same global Node.js installation

Next Steps