.. Wilfred documentation master file, created by
sphinx-quickstart on Sat May 2 21:42:47 2020.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
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.
* `Docker on Linux `__
* `Docker Desktop on MacOS `__
* `Docker Desktop on Windows `__
You can verify that Docker is installed using ``docker --version`` or ``docker info`` (``info`` shows more information).
.. code-block:: bash
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.
.. code-block:: bash
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!).
.. code-block:: bash
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``).
.. code-block:: bash
pip install wilfred --upgrade
You can install using a specific python version, e.g. `3.8`.
.. code-block:: bash
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.
.. code-block:: bash
wilfred setup
Currently, the only config option required is the path for soring data.
.. code-block:: text
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).
.. code-block:: bash
pip install wilfred --upgrade
If you installed Wilfred using ``brew``, you can use Homebrew to upgrade Wilfred as you would do with any formula.
.. code-block:: bash
brew update
brew upgrade
.. toctree::
:maxdepth: 3
:hidden:
commands
images
api
development
Indices and tables
==================
* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`