Self-hosted web dashboard for PM2. No cloud, no subscriptions.
Installs as a single npm package, runs on the same server as PM2.

Until version 1.0.0, this project is under active development. Production use is possible, but expect breaking changes and missing features.

• Process list with CPU, RAM, status
• Start, stop, restart
• Uptime and restart counters
• Authentication
• First-run setup link with initial admin account creation
• Single npm package with API and static web UI

• Real-time process updates
• Log viewer with real-time tail
• Metrics history with graphs
• Alerts
• Environment variables management from the UI
• Cluster management

1. Start the dashboard with npx pm2-dashboard, or install it globally with npm install -g pm2-dashboard and then run pm2-dashboard.
2. Copy the setup URL printed by the CLI.
3. Open the link and create the initial admin account.
4. Log in to access the dashboard.

• Node.js >= 22
• PM2 running on the same server

# One-time run
npx pm2-dashboard

# Global install
npm install -g pm2-dashboard
pm2-dashboard

Starts on http://localhost:3000 by default.

pm2 start pm2-dashboard

pm2-dashboard --host=127.0.0.1 --port=4000 --db=~/.pm2-dashboard/data.db

HOST=127.0.0.1 PORT=4000 DB_PATH=~/.pm2-dashboard/data.db pm2-dashboard

Config priority: CLI flags, environment variables, defaults.

Defaults:

• Host: 127.0.0.1
• Port: 3000
• Database: ~/.pm2-dashboard/data.db

Use 127.0.0.1 to restrict access to localhost.

Use pm2-dashboard --help to see available CLI options.

The package binds to 127.0.0.1:3000 by default.

On the first launch, the CLI prints a setup URL with a one-time token. After the initial account is created, access requires login.

For public access, place the dashboard behind a trusted reverse proxy or inside a private network.

• API: NestJS + TypeScript
• UI: Svelte 5 + TypeScript + Tailwind 4 + Skeleton
• Database: SQLite via Drizzle ORM
• Authentication: setup token for first run, session-based login after setup
• Packaging: single npm package serving API and static web UI
• Runtime model: runs on the same server as PM2

• apps/api: backend API, auth, PM2 integration, SQLite storage
• apps/web: browser UI built with Svelte 5
• packages/shared: code shared between API and frontend
• packages/pm2-dashboard: published npm package and CLI entrypoint

git clone https://github.com/orchidfiles/pm2-dashboard.git
cd pm2-dashboard
pnpm install

VSCode tasks are configured in .vscode/tasks.json. Run build-watch all to compile dev-kit, shared, and API in watch mode. Run start all to start API and web dev server.

Build the npm package from source:

pnpm run package:build

Run the dashboard on localhost and proxy it through nginx:

server {
    listen 80;
    server_name dashboard.example.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_cache_bypass $http_upgrade;
    }
}

Run certbot separately for TLS.

PM2 ships with a terminal interface. When you need browser access without SSH, the official option is PM2 Plus (paid SaaS).

Every open source alternative is either abandoned or built without structure: plain JS files, no modules, no clear architecture.

pm2-dashboard is a TypeScript monorepo with a NestJS backend, Svelte 5 frontend, and a shared package layer. It is built to be maintained and extended over time.

Open source alternatives:

Issues and pull requests are welcome. The project is actively maintained.

MIT

Made by the author of orchidfiles.com — essays from inside startups.
If you found pm2-dashboard useful, you'll probably enjoy the essays.