Wilfred is a command-line interface for running and managing game servers locally. It uses Docker to run game servers in containers, which means they are completely separated. Wilfred can run any game that can run in Docker.


The documentation has just been migrated to Sphinx. It’s currently being updated and things may change at any time. We’re also preparing for the Wilfred API to be documented here.



Wilfred currently supports Linux (should be everywhere where Python and Docker is supported), MacOS and now Windows.

Before installing, make sure you have Docker already installed and configured. You can install it from the links below.

You can verify that Docker is installed using docker --version or docker info (info shows more information).

user@host:~$ docker --version
Docker version XX.XX.X, build XXXXXXXXXX

If you’re having trouble accessing the Docker CLI as a non-root user, you can add yourself to the Docker group.


The recommended way of installing Wilfred is via Homebrew (works on macOS and Linux). Make sure you have it installed on your system. Once Homebrew is installed, use the two commands below to install Wilfred via the offical tap.

brew tap wilfred-dev/wilfred
brew install wilfred

Want the bleeding edge? You can install the latest commit using --HEAD (bugs are to be expected, don’t use in production environments!).

brew tap wilfred-dev/wilfred
brew install --HEAD wilfred


Wilfred can be installed using pip. You need to use Python 3.6 or newer to run Wilfred (if you also have pip2 on your system, run with pip3).

pip install wilfred --upgrade

You can install using a specific python version, e.g. 3.8.

python3.8 -m pip install wilfred --upgrade

Snap (experimental)


The snap package is not considered stable. You can only install it using the –devmode which is not recommended in a production environment. For now, please use the pip package. See issue #6 for updates regarding the snap package.


Snapcraft is configured to automatically build the latest commit and push it to the edge release branch. These releases can be installed using snap. Currently, the same releases pushed to Pip are also pushed to the beta branch.

snap install wilfred --beta --devmode

Again, the --beta channel and --devmode should not be used in a production environment.

Basic Configuration

Once you got Wilfred installed, you can run the setup command to create the basic configuration.

wilfred setup

Currently, the only config option required is the path for soring data.

Path for storing server data [/home/{{ username }}/wilfred-data/servers]:

By default, this is /home/{{ username }}/wilfred-data/servers. You can use any path as long as you have permissions to access it as the current user.

To create a new server, you can run wilfred create and follow the instructions.


To check if you’re running the latest version, run wilfred --version. If a new version is available, Wilfred will print a message.

If you installed Wilfred using pip, then you can upgrade by running the same command as for installing (note the --upgrade flag).

pip install wilfred --upgrade

If you installed Wilfred using snap, you can use refresh to download the latest version (snap should automatically update).

snap refresh wilfred

If you installed Wilfred using brew, you can use Homebrew to upgrade Wilfred as you would do with any formula.

brew update
brew upgrade

Indices and tables