OpsVibes Docs

Installation

Install OpsVibes on a fresh Linux server in a few minutes.

Install with the script

Run this command as root (or with sudo) on a fresh Linux server with at least 2 GB of RAM. Ports 80 and 443 must be free.

curl -sSL https://get.opsvibes.com | sudo sh

The script will:

  • Detect your Linux distribution (Ubuntu, Debian, Rocky, AlmaLinux, RHEL, CentOS Stream, Fedora).
  • Install Docker if it is missing and enable it at boot.
  • Open ports 80, 443 and 3000 when ufw or firewalld is active.
  • Start OpsVibes and Traefik, then print the address of your panel.

See Requirements for the supported distributions and versions.

Operating systemVersions
UbuntuRecommended20.04, 22.04, 24.04 LTS
DebianRecommended11, 12
Rocky Linux8, 9
AlmaLinux8, 9
Red Hat Enterprise Linux8, 9
CentOS Stream9
Fedora40, 41

Install with Docker

If you prefer to control every step, or your server already has Docker, you can run OpsVibes with Docker directly. First install Docker for your distribution (skip this if docker --version already works):

curl -fsSL https://get.docker.com | sudo sh
sudo dnf -y install dnf-plugins-core
sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo dnf -y install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker

On RHEL you can replace linux/centos with linux/rhel in the repository URL.

curl -fsSL https://get.docker.com | sudo sh
sudo systemctl enable --now docker

Then start OpsVibes:

docker network create opsvibes
docker run -d --name opsvibes --network opsvibes \
  --restart unless-stopped \
  -p 3000:3000 \
  -v /etc/opsvibes:/etc/opsvibes \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /proc:/host/proc:ro \
  -e OPSVIBES_HOST_PROC=/host/proc \
  ghcr.io/opsvibes/opsvibes:latest
docker network create opsvibes
docker run -d --name opsvibes --network opsvibes \
  --restart unless-stopped \
  -p 3000:3000 \
  -v /etc/opsvibes:/etc/opsvibes \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /proc:/host/proc:ro \
  -e OPSVIBES_HOST_PROC=/host/proc \
  --security-opt label=disable \
  ghcr.io/opsvibes/opsvibes:latest

--security-opt label=disable lets the panel use the Docker socket while SELinux is enforcing.

The panel creates a opsvibes-traefik container that takes ports 80/443 and issues Let's Encrypt certificates. You do not need to install Nginx or Traefik yourself.

First login

  1. Open the panelGo to http://<server-ip>:3000 in your browser.
  2. Get the setup tokenSo that only the server owner can create the admin account, the panel asks for a code that can only be read on the server:
    sudo cat /etc/opsvibes/setup.token
  3. Create the admin accountPaste the setup token and enter your email and password. The token is removed once the first account exists.
  4. Give the panel a domainOpen Settings → Domains & SSL to serve the panel over HTTPS. See Domain and HTTPS.

Next steps

RequirementsDistributions, hardware and network ports.
Domain and HTTPSPoint DNS and enable SSL for the panel and apps.
Updating and uninstallingUpgrade, back up the panel, remove it from a server.
TroubleshootingBusy ports, SELinux, panel not starting.