Operating System CentOS

How to Install PufferPanel on Ubuntu 24.04 or AlmaLinux 9 (Minecraft Panel)

Install PufferPanel 3 from the official package repository on Ubuntu 24.04 or AlmaLinux 9, create the admin user, run game servers in Docker and put nginx with TLS in front.

PufferPanel is a free, open-source web panel for running game servers such as Minecraft: you create servers from templates, start and stop them, use a console and edit files from the browser. By the end of this guide you will have PufferPanel 3 running as a systemd service, an administrator account, Docker isolation for the game servers and, optionally, HTTPS through nginx.

CentOS 7 reached end of life in June 2024, and the PHP-based PufferPanel 1.x with its separate Scales daemon that older tutorials describe is long gone. Current PufferPanel is a single Go binary with its own package repository; it needs no PHP, web server or MySQL setup. The project's support table lists Ubuntu 22.04 and 24.04 and Debian 10 and 11, and it publishes a generic RPM repository for the Red Hat family, so this guide uses Ubuntu 24.04 LTS as the main platform and gives the documented commands for AlmaLinux 9 and Rocky Linux 9. Ubuntu 26.04 is not in the support table yet; if you run it, use the Docker installation.

Requirements

  • A 64-bit server (AMD64 or ARM64). 32-bit systems are not supported.
  • A user with sudo rights.
  • Enough memory for the games you plan to host. A Minecraft Java server needs considerably more RAM than the panel itself.
  • TCP ports 8080 (web interface) and 5657 (SFTP) reachable, plus the ports of your game servers, for example 25565 for Minecraft Java Edition.

Step 1: Install PufferPanel

Ubuntu 24.04 (and Debian)

Add the signing key and the repository, then install the package:

sudo apt-get install curl gnupg apt-transport-https
curl -fsSL https://packagecloud.io/pufferpanel/pufferpanel/gpgkey | gpg --dearmor | sudo tee /etc/apt/keyrings/pufferpanel.gpg > /dev/null
sudo tee /etc/apt/sources.list.d/pufferpanel.sources > /dev/null <<'EOF'
X-Repolib-Name: PufferPanel
Types: deb
URIs: https://packagecloud.io/pufferpanel/pufferpanel/any/
Suites: any
Components: main
Signed-By: /etc/apt/keyrings/pufferpanel.gpg
EOF
sudo apt update
sudo apt-get install pufferpanel

AlmaLinux 9 / Rocky Linux 9

Create the repository file and install with dnf. The quoted 'EOF' keeps $basearch literal so that dnf, not the shell, expands it:

sudo tee /etc/yum.repos.d/pufferpanel.repo > /dev/null <<'EOF'
[pufferpanel]
name=pufferpanel
baseurl=https://packagecloud.io/pufferpanel/pufferpanel/rpm_any/rpm_any/$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/pufferpanel/pufferpanel/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300
EOF
sudo dnf install pufferpanel

Alternative: run the panel in Docker

On any distribution with Docker Engine installed, the project's container image works the same way. Mounting the Docker socket lets the panel start a container per game server:

docker volume create pufferpanel-config
docker volume create pufferpanel-servers
docker create --name pufferpanel \
  -p 8080:8080 -p 5657:5657 \
  -v pufferpanel-config:/etc/pufferpanel \
  -v pufferpanel-servers:/var/lib/pufferpanel:z \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --restart=on-failure \
  pufferpanel/pufferpanel:latest

Step 2: Create the administrator

Add the first user from the command line and answer Y when asked whether the user is an admin:

sudo pufferpanel user add

For the container installation, start it first and run the command inside:

docker start pufferpanel
docker exec -it pufferpanel /pufferpanel/bin/pufferpanel user add

Step 3: Start the panel and open the firewall

sudo systemctl enable --now pufferpanel

Check that it is running:

systemctl status pufferpanel

Open the panel and SFTP ports. On Ubuntu with UFW:

sudo ufw allow 8080/tcp
sudo ufw allow 5657/tcp

On AlmaLinux or Rocky Linux with firewalld:

sudo firewall-cmd --permanent --add-port=8080/tcp --add-port=5657/tcp
sudo firewall-cmd --reload

Browse to http://203.0.113.10:8080 (your server's address) and sign in with the account you just created.

Step 4: Run game servers in Docker

PufferPanel can run servers in two environments. The standard environment starts them as ordinary processes on the host; the documentation states plainly that this is not secure, because servers can read host files, and should be used for testing only. The docker environment gives every server its own container. Skip this step if the panel itself runs in Docker.

Install Docker Engine from Docker's own repository following Docker's installation instructions. On Ubuntu do not use the snap package, which cannot write to /var/lib/pufferpanel. Then let the panel's service user talk to Docker and restart it:

sudo groupadd --force --system docker
sudo usermod -a -G docker pufferpanel
sudo systemctl restart pufferpanel

Step 5: Create a Minecraft server

In the web interface, create a new server, pick one of the Minecraft templates, choose the docker environment, and set the port and memory. Run the server's install action, then start it and watch the console. Minecraft requires you to accept Mojang's EULA before a server starts; the template asks for this as a setting. Finally open the game port in the firewall, for example:

sudo ufw allow 25565/tcp

Files can be managed in the browser or over SFTP on port 5657 with your panel login.

Step 6: Add HTTPS with nginx (optional)

For a public panel, point a domain such as panel.example.com at the server and put nginx in front. Install nginx and Certbot (sudo apt-get install nginx certbot python3-certbot-nginx on Ubuntu; on AlmaLinux or Rocky enable EPEL first with sudo dnf install epel-release, then install the same three packages with dnf). Create /etc/nginx/conf.d/pufferpanel.conf:

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

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Nginx-Proxy true;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
        proxy_set_header Host $host;
        client_max_body_size 100M;
    }
}

Reload nginx and request the certificate:

sudo systemctl restart nginx
sudo certbot --nginx -d panel.example.com

Then stop the panel from listening on the public interface. Add this block at the top level of /etc/pufferpanel/config.json (next to the panel section, not inside it) and restart PufferPanel:

"web": {
  "host": "127.0.0.1:8080"
}

Allow ports 80 and 443 in the firewall and close 8080 again. On AlmaLinux and Rocky Linux, SELinux blocks nginx from connecting to a backend port by default; allow it with sudo setsebool -P httpd_can_network_connect 1.

Updating

PufferPanel updates arrive through the package repository, so the normal system update covers it:

sudo apt update && sudo apt-get install --only-upgrade pufferpanel

On the Red Hat family use sudo dnf upgrade pufferpanel. For the container, pull the new image and recreate the container; the two named volumes keep your configuration and servers. Back up /etc/pufferpanel and /var/lib/pufferpanel before a major upgrade.

Frequently asked questions

Do I still need PHP, MySQL or the Scales daemon?

No. Those belonged to PufferPanel 1.x. The current release is one binary that contains both the web panel and the daemon that controls servers, and the package sets up its own service and data directory.

Is PufferPanel only for Minecraft?

No. It ships templates for a range of games and you can write your own. Minecraft Java and Bedrock are simply the most common use.

Can other people manage their own servers?

Yes. Create additional users in the panel and grant them access per server. If those users are not fully trusted, use the docker environment so their servers are isolated from the host and from each other.

The panel works but players cannot connect. Why?

The game port is usually closed. Check the port configured for the server in the panel, open it in the host firewall and in any firewall offered by your hosting control panel, and confirm the server shows as running in the console.

Share story:

Continue reading other guides on How VPS.