Docker-Maniaplanet

This work is based on PyPlanet docker image (https://github.com/PyPlanet/maniaplanet-docker).

My goal is to be up-to-date and to be much more customisable.

• Use latest alpine image
• Use latest Maniaplanet server
• Lighter image
• Multi architectures (see below)
• Cleaner and more readable Dockerfile and entrypoint
• Every dedicated_cfg option is customisable through environment variable
• Pterodactyl compliant (https://github.com/pterodactyl/panel)

Works great with https://git.tools01.noxinmortus.fr/sysadmins/docker/docker-maniacontrol

This image is rootless.

Official NoxInmortus repositories

Find more at :

• https://hub.docker.com/u/noxinmortus
• https://git.tools01.noxinmortus.fr/public
• https://github.com/NoxInmortus?tab=repositories

Available Architectures

• amd64
• arm64 (aarch64)
• armv7 (arm)

Common Usage

docker run --name=maniaplanet -d -v maniaplanet:/home/container --restart=unless-stopped \
  -p 2350:2350 -p 2350:2350/udp -p 3450:3450 -p 3450:3450/udp \
  -e MASTERSERVER_ACCOUNT='MyAccountName' \
  -e MASTERSERVER_ACCOUNT_PWD='P@55w0rd' \
  -e MASTERSERVER_KEY='yOuRkEy' \
  -e SUPERADMIN_PWD='AnotherP@55w0rd' \
  -e ADMIN_PWD='AnotherP@55w0rd' \
  -e SERVER_NAME='Aw3s0meS3rV3r' \
  -e MAX_PLAYERS='16' \
  -e MAX_SPECTATORS='6' \
  -e SERVER_PASSWORD='s0m371ng' \
 noxinmortus/docker-maniaplanet

Once started, you can also manually edit the config.xml as it will not be overwritten if the file exist. Same thing for the matchsettings.xml

User / Group Identifiers

When using volumes (-v flags) permissions issues can arise between the host OS and the container, we avoid this issue by allowing you to specify the user UID and group GID :

-e UID=1000 # for UserID
-e GID=1000 # for GroupID

Ensure any volume directories on the host are owned by the same user you specify and any permissions issues will vanish like magic.

In this instance UID=1000 and GID=1000, to find yours use id user as below:

  $ id username
    uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

Configuration

Volume to mount is /home/container (to be Pterodactyl compliant) and contains all maniaplanet files.

Sources

• https://github.com/PyPlanet/maniaplanet-docker
• http://blog.zot24.com/tips-tricks-with-alpine-docker/
• https://doc.maniaplanet.com/dedicated-server/getting-started
• https://pterodactyl.io/community/config/eggs/creating_a_custom_image.html#creating-the-dockerfile

Lint with :

• https://github.com/hadolint/hadolint
• https://github.com/koalaman/shellcheck