Docs / Usage

Command Reference

Name: Easy DevOps
Author: Omar Farghaly

Launch with easy-devops or the short alias ezz — both are registered as npm bin commands and do the same thing. Select an option with arrow keys, then follow the sub-menu prompts.

CLI Banner

terminal

  ███████╗███████╗     Easy DevOps  v1.2.1
  ██╔════╝╚════██╗     ─────────────────────
  █████╗      ██╔╝     CLI & Web Dashboard
  ██╔══╝     ██╔╝      Nginx · SSL · Domains · Node.js
  ███████╗ ██████╗
  ╚══════╝ ╚═════╝

  nginx: ✅ v1.26.2 | ACME: acme-client | node: v22.21.1

? Select an option:
❯ 📦 Node.js Manager
  🌐 Nginx Manager
  🔒 SSL Manager
  🔗 Domain Manager
  🎛️ Open Dashboard
  ⚙️ Settings
  🔄 Check for Updates
  ✖ Exit

All Commands

Command	Description
Node.js Manager	Switch Node versions, manage global packages, update npm.
Nginx Manager	Reload, restart, test config, view error log, install nginx.
SSL Manager	List certs, issue new certs (HTTP-01 or DNS-01), renew expiring certs.
Domain Manager	List, add, edit, enable/disable, delete reverse proxy configs.
Open Dashboard	Starts the Express + Vue 3 web dashboard.
Settings	Configure ports, directories, passwords, ACME email, and Linux permissions.
Check for Updates	Checks npm registry for a new version of easy-devops.
Exit	Exit the CLI gracefully. Press Ctrl+C at any time.

Command	Description
Reload nginx	Tests config, then sends graceful reload signal.
Restart nginx	Tests config, then full stop/start.
Test config	Runs nginx -t and displays the result.
View error log	Shows the last 50 lines of the Nginx error log.
Install nginx	Installs via apt-get (Linux) or winget (Windows).

Command	Description
List Domains	Show all configured domains in a table with status.
Add Domain	Interactive prompts for domain configuration.
Edit Domain	Modify existing domain settings.
Enable / Disable	Toggle domain on/off without deleting the config.
Delete Domain	Remove domain (optionally delete SSL files too).

Command	Description
Create new certificate	Issue a new Let's Encrypt certificate via HTTP-01 or DNS-01 challenge.
Renew a certificate	Select and renew a specific certificate by domain.
Renew all expiring (< 30 days)	Batch-renew all certificates expiring within 30 days.

Command	Description
Switch Node version	List available LTS versions, switch to selected version.
Manage global packages	Install, uninstall, or list globally installed npm packages.
Update npm	Updates npm to the latest version.

Command	Description
Dashboard Port	Set the port the web dashboard listens on (default: 6443).
Dashboard Password	Change the login password for the web dashboard.
Nginx Directory	Set the nginx installation path (nginxDir).
SSL Directory	Set the SSL certificate storage root (sslDir).
ACME Email	Set the email used for Let's Encrypt account registration.
Setup Linux Permissions	Linux only. Runs sudo -v then writes /etc/sudoers.d/easy-devops with NOPASSWD rules for systemctl and the detected nginx binary. Required for nginx service control from the dashboard. Shows ✅ configured once done.