Skip to main content

All-in-one with Traefik

This variant is recommended if you want to host on a small machine with a low amount of players and want to host your MU Online website on the same machine. Traefik acts as reverse proxy, so multiple websites can share ports 80 and 443.

All kinds of OpenMU subsystems (connect server, game server, login server, admin panel, …) still run in one process, but the admin panel and other websites can be routed separately.

How routing works​

You tell Traefik how to handle incoming requests by adding labels to a container:

services:
  admin-panel:
    # ...
    labels:
      - "traefik.enable=true"
      - "traefik.docker.network=proxy"
      - "traefik.http.routers.adm.entrypoints=websecure"
      - "traefik.http.routers.adm.rule=Host(`admin.domain.com`)"
      - "traefik.http.routers.adm.middlewares=auth"
      - "traefik.http.middlewares.auth.basicauth.usersfile=.htpasswd"

  muonline-website:
    # ...
    labels:
      - "traefik.enable=true"
      - "traefik.docker.network=proxy"
      - "traefik.http.routers.muonline.entrypoints=websecure"
      - "traefik.http.routers.muonline.rule=Host(`muonline.domain.com`)"

You can even add multiple domains and/or subdomains to one host label:

- "traefik.http.routers.muonline.rule=Host(`www.domain1.com`,`domain1.com`,`sub.domain1.com`)"

Deployment with docker compose​

Install git​

See the git install guide.

Clone the repository​

git clone https://github.com/MUnique/OpenMU.git
cd OpenMU/deploy/all-in-one-traefik

Create a docker network​

The containers of different docker compose files need to communicate with each other:

docker network create proxy

Option A — for local testing​

docker compose -f docker-compose.yml up -d

It's then available on your local computer through a loopback IP. The admin panel URL is http://admin.docker.localhost. You can change it in the docker-compose.yml file.

Option B — with HTTPS​

If you want to share your server with the world, set up HTTPS — Traefik can handle it for you. Otherwise, traffic from and to the admin panel is not encrypted.

Copy .env.example to .env and edit it with the domain/subdomain of your admin panel URL:

cp .env.example .env

Copy data-traefik/acme.example.json to data-traefik/acme.json and give it permission 600:

cp data-traefik/acme.example.json data-traefik/acme.json
chmod 600 data-traefik/acme.json

Then run it:

docker compose -f docker-compose.prod.yml up -d

Admin panel users​

Restart Traefik after adding a user

Avoid editing the .htpasswd manually. Instead, add the user in the admin panel on the Users page. With the Traefik deployment you need to restart Traefik after adding a user for it to take effect.

What's next​

The server is automatically started and initialized for Season 6.

Go to the admin panel — locally that is http://admin.docker.localhost/. The default user name is admin and the password is openmu; change that before the server is reachable from the internet.

If you want to run another game version, use the Setup page.