Wilfred¶
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.
Warning
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.
Installation¶
Prerequisites¶
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.
Homebrew¶
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
Pip¶
Wilfred can be installed using pip
. You need to use Python 3.7 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
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.
Upgrading¶
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 brew
, you can use Homebrew to upgrade Wilfred as you would do with any formula.
brew update
brew upgrade