Installing PufferPanel using Docker

The Docker image is currently X86_64 only due to limitations in the Github Actions infrastructure.

PufferPanel offers several images that include dependencies needed to run game servers. We recommend using latest as it contains everything you will need to get servers runing quickly.

Creating the container

To create the container, start it, and add the default user:

$ mkdir -p /var/lib/pufferpanel
$ docker volume create pufferpanel-config
$ docker create --name pufferpanel -p 8080:8080 -p 5657:5657 -v pufferpanel-config:/etc/pufferpanel -v /var/lib/pufferpanel:/var/lib/pufferpanel -v /var/run/docker.sock:/var/run/docker.sock --restart=on-failure pufferpanel/pufferpanel:latest
$ docker start pufferpanel
$ docker exec -it pufferpanel /pufferpanel/pufferpanel user add

And you’re done. Your panel is now accessible at http://localhost:8080

Understanding the config

With the usage of Docker, we move the configuration options to be environment variables. This means you don’t have to override the config.json to apply changes. You can use the following to get all of the environment variables on the container.

docker inspect pufferpanel --format='{{range .Config.Env}}{{println .}}{{end}}'

The variables follow the format of the JSON config, just using _ to handle children instead of {}.



This includes all the dependencies for game servers that we include in our templates. This is a combination of all below images. This is the best image for just getting the panel up and running with little effort.


This includes both Java 8 and Java 16 from OpenJDK. This lets you handle both pre-1.17 and 1.17+ Minecraft: Java Edition servers. Java 8 is accessible by using java8 as your Java command with javac8 for the compiler. Java 16 is accessible by using java16 as your Java command with javac16 for the compiler. Java 16 is the default JRE if java is used.


This includes all SRCDS dependencies for game servers such as CS:GO.


This includes all NodeJS dependencies.


This is a no-dependency installation that only includes the panel. This is the recommended image for just running the panel or if you need to create a custom image.