Self-Hosted VPS Installation Guide

PanelOps can be installed directly onto your bare metal or virtual private server (VPS) in under 3 minutes using the official one-click installer.

1. System Requirements

Before running the installer, ensure your server meets these baseline specifications:

Resource	Minimum	Recommended
Operating System	Ubuntu 20.04+, Debian 11+, CentOS 8+, AlmaLinux, Rocky, Fedora	Ubuntu 22.04 LTS or Debian 12
Architecture	x86_64 or aarch64 (ARM64)	x86_64 or aarch64
CPU	1 Core	2+ Cores
RAM	1 GB (Low-Memory Mode active under 850 MB)	2+ GB
Disk Space	3 GB Free	20+ GB SSD/NVMe
Privileges	Root or sudo access	Root

2. Quick Installation Command

Run the following command in your server terminal as root:

curl -fsSL https://panelops.online/install.sh | sudo bash

Installation with Custom Options

The installer accepts optional flags:

curl -fsSL https://panelops.online/install.sh | sudo bash -s -- [OPTIONS]

Flag	Argument	Description	Default
`--token`, `-t`	`<PAIRING_TOKEN>`	Node pairing token generated from PanelOps Cloud	None
`--cloud`, `-c`	`<URL>`	Authoritative PanelOps Cloud Control Plane URL	`https://panelops.online`
`--port`, `-p`	`<PORT>`	Customer Node local Web Panel HTTP port	`8080`

Example with Pairing Token:

curl -fsSL https://panelops.online/install.sh | sudo bash -s -- --token YOUR_TOKEN_HERE --port 8080

3. What the Installer Does

Hardware & OS Verification: Detects Linux distribution, architecture, CPU count, RAM, and disk storage.
System Dependencies: Installs curl, wget, git, tar, jq, ufw/firewalld, openssl, and prerequisite tools.
Docker Engine: Checks for Docker and Docker Compose; installs official upstream Docker if missing.
Local Directory Structure: Sets up /opt/panelops with locked file permissions (0600 on secrets).
Local VPS Node Provisioning: Initializes the native systemd service (panelops.service) to start on boot.
Firewall Rules: Automatically opens necessary ports (8080 or chosen port, 80, 443).
Cloud Control Plane Enrollment: If a --token is provided, pairs with your Cloud account securely.

4. Post-Installation Access

Once the installation finishes, the terminal displays your node connection details:

===================================================================
  🎉 PanelOps VPS Node Installed Successfully!
===================================================================
  • Local Web Panel : http://YOUR_SERVER_IP:8080
  • Installation Dir: /opt/panelops
  • Systemd Service : systemctl status panelops
===================================================================

Open http://YOUR_SERVER_IP:8080 in your web browser to initialize your administrator account and begin deploying applications!