Installation Guide

From zero to Bpanel in under 2 minutes.

1

Get a VPS

You need a VPS running Ubuntu 20.04+ or Debian 11+ with root access. Any provider works — Hetzner, DigitalOcean, OVH, Contabo, whatever.

OS Ubuntu 20.04+ / Debian 11+
RAM 512 MB minimum
Disk ~50 MB for Bpanel
Access Root
2

Run the Installer

SSH into your VPS as root and run:

bash
bash <(curl -fsSL https://raw.githubusercontent.com/convro/Bpanel/main/install.sh)

The installer automatically:

  • Installs Node.js 20 (if not present)
  • Installs build tools (gcc, python3, make)
  • Clones Bpanel to /opt/bpanel
  • Installs npm dependencies
  • Creates a systemd service
  • Starts Bpanel on port 9390
Alternative: Manual install
bash
git clone https://github.com/convro/Bpanel.git /opt/bpanel
cd /opt/bpanel
npm install
node bpanel.js
3

Open Firewall

Make sure port 9390 is open. If you use UFW:

bash
ufw allow 9390/tcp

Also check your VPS provider's firewall/security group settings if they have one.

4

Open Bpanel

Navigate to your VPS IP + port in the browser:

URL
http://YOUR_VPS_IP:9390

You'll see the registration form. Create your account — the first user registered becomes the admin and registration locks after that.

5

Create a Session

After logging in, click + New Session. Give it a name and set the working directory (e.g. /root or /var/www/myapp).

Click into the session to access the file manager, code editor, and terminal. You're done.

Optional: Domain + HTTPS

Want to use a domain like panel.yourdomain.com? Set up Nginx as a reverse proxy:

/etc/nginx/sites-available/bpanel
server {
    listen 80;
    server_name panel.yourdomain.com;

    location / {
        proxy_pass http://127.0.0.1:9390;
        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;
    }
}
bash
ln -s /etc/nginx/sites-available/bpanel /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
apt install certbot python3-certbot-nginx
certbot --nginx -d panel.yourdomain.com

Need help?
Check the docs.