Installation Instructions

Wiki Races Installation

Wiki Races is intended to be run on a Linux system. It has been proven to work on Ubuntu Server 20.04.2 and 22.04.1, as well as Fedora 37 and 40.

A reverse proxy is also recommended, as the default configuration is to start on port 8443.

Installing Wiki Races with Docker (Recommended)

First, Install Docker.

Then, download and run the server:

git clone https://github.com/interalliancegc/wikiraces
cd wikiraces
# to build for the first time
docker compose up
# to detach output for deployment on server
docker compose up -d
# to rebuild after making chainges
docker compose build && docker compose up
# to shut down
docker compose down

For other installation options, see the guide in the Wiki.

---

Reverse-Proxy configuration.

TechOlympics 2024 used this Apache configuration file to send traffic from wiki-races.interalliance.org to the Docker container. Apache must be installed to use this, alongside the mod_proxy plugin.

Installing Apache on Ubuntu Server

sudo apt install apache2
sudo service apache2 start
sudo a2enmod proxy
sudo a2enmod proxy_http
sudo nano /etc/apache2/wiki.conf

wiki.conf Configuration File

<VirtualHost *:80>
        ServerName wiki-races.example.org

        ServerAdmin webmaster@localhost
        ProxyPass / http://localhost:8443/
        ProxyPassReverse / http://localhost
        # Available loglevels: trace8, ..., trace1, debug, info, notice, warn,
        # error, crit, alert, emerg.
        # It is also possible to configure the loglevel for particular
        # modules, e.g.
        #LogLevel info ssl:warn

        ErrorLog ${APACHE_LOG_DIR}/error.log
        CustomLog ${APACHE_LOG_DIR}/access.log combined

        # For most configuration files from conf-available/, which are
        # enabled or disabled at a global level, it is possible to
        # include a line for only one particular virtual host. For example the
        # following line enables the CGI configuration for this host only
        # after it has been globally disabled with "a2disconf".
        #Include conf-available/serve-cgi-bin.conf
</VirtualHost>

# vim: syntax=apache ts=4 sw=4 sts=4 sr noet