easy-vps

Install dependencies, point domains, deploy apps and run Postgres on a VPS from one UI.

easy-vps is a control panel that runs on your server and gives you a web interface for managing nginx, pm2, docker, certbot, and PostgreSQL, plus deploying apps and pointing domains — all from a single dashboard.

Requirements

• A Linux server (systemd-based distros recommended: Ubuntu, Debian, etc.)
• Node.js >= 18 (the easy-vps CLI requires it)
• npm (ships with Node.js)
• root/sudo access if you want the panel to run as a systemd service and open its firewall port automatically. Without root it still runs as a background process, just without service management and firewall changes.

Optional, used by their respective features:

• nginx + certbot — domain / HTTPS management
• pm2 or docker — app deployment
• postgres — managed databases
• ufw — automatic firewall port opening

Install

Install globally from npm:

npm install -g easy-vps

The postinstall script automatically:

1. Verifies the package payload
2. Prepares the web UI
3. Opens the panel's port in ufw (when run as root with an active firewall)
4. Starts the panel as a background service (systemd when available, otherwise a detached process)

When it finishes, open the printed URL in your browser:

http://<your-server-ip>:41556/

Install from source

git clone <repo-url> easy-vps
cd easy-vps
npm install
npm run build
node bin/cli.js start

The web UI is prebuilt in the published tarball. From a source checkout the UI is built from client-ui/ during npm run build.

Commands

The easy-vps command exposes the following subcommands:

easy-vps                 # run the panel in the foreground (default)
easy-vps start          # start the panel in the background
easy-vps stop           # stop the background panel
easy-vps restart        # restart the background panel
easy-vps status         # show whether the panel is running
easy-vps logs           # print the path to the panel log
easy-vps uninstall      # stop the panel and remove its service
easy-vps --help         # show full help

Options

  -p, --port <port>     Port to listen on (default: 41556, env: EASY_VPS_PORT)
      --host <host>     Address to bind (default: 0.0.0.0, env: EASY_VPS_HOST)
  -v, --version         Print version
  -h, --help            Show help

Example:

easy-vps start --port 8080 --host 127.0.0.1

Configuration

| Variable | Default | Description | | -------------------- | ----------- | ------------------------------------ | | EASY_VPS_PORT | 41556 | Port the panel listens on | | EASY_VPS_HOST | 0.0.0.0 | Address the panel binds to | | EASY_VPS_NO_AUTOSTART | unset | Set to skip the postinstall service start |

Uninstall

easy-vps uninstall
npm rm -g easy-vps

Run easy-vps uninstall first so the systemd unit (if created) is removed cleanly before removing the package.

Service behavior

• With systemd + root: a easy-vps.service unit is created, enabled, and restarted on boot. Logs: journalctl -u easy-vps -f.
• Without systemd / not root: the panel runs as a detached background process. Logs are written to ~/.easy-vps/easy-vps.log (or /var/lib/easy-vps/easy-vps.log when run as root).