2023-05-09 16:08:19 -04:00
|
|
|
[Git](https://code.nephatrine.net/NephNET/docker-minecraft-mcu/src/branch/master) |
|
2020-08-15 17:55:59 -04:00
|
|
|
[Docker](https://hub.docker.com/r/nephatrine/minecraft-mcu/) |
|
|
|
|
[unRAID](https://code.nephatrine.net/nephatrine/unraid-containers)
|
|
|
|
|
|
|
|
# Minecraft Server
|
|
|
|
|
|
|
|
This docker image contains a Minecraft server to self-host your own Java
|
|
|
|
Edition server and optionally MCUpdater modpack.
|
|
|
|
|
2023-05-09 16:08:19 -04:00
|
|
|
To secure this service, we suggest a separate reverse proxy server, such as an
|
|
|
|
[NGINX](https://nginx.com/) container.
|
2020-08-15 17:55:59 -04:00
|
|
|
|
2023-05-09 16:08:19 -04:00
|
|
|
- [Alpine Linux](https://alpinelinux.org/) w/ [S6 Overlay](https://github.com/just-containers/s6-overlay)
|
|
|
|
- [Minecraft](https://minecraft.net/) w/ [MCUpdater](https://mcupdater.com/)
|
2020-08-15 17:55:59 -04:00
|
|
|
|
|
|
|
**Please note, you will still need to agree to the EULA the first time you
|
|
|
|
start up the server by changing ``eula=false`` to ``eula=true`` in the
|
|
|
|
``/mnt/config/data/server/eula.txt`` file.**
|
|
|
|
|
|
|
|
This container does not currently include its own web server. To expose your
|
|
|
|
modpack to the public, you will need to host the modpack directory on a web
|
|
|
|
server.
|
|
|
|
|
|
|
|
You can spin up a quick temporary test container like this:
|
|
|
|
|
|
|
|
~~~
|
|
|
|
docker run --rm -p 25565:25565 -it nephatrine/minecraft:latest /bin/bash
|
|
|
|
~~~
|
|
|
|
|
|
|
|
## Configuration Variables
|
|
|
|
|
|
|
|
You can set these parameters using the syntax ``-e "VARNAME=VALUE"`` on your
|
|
|
|
``docker run`` command. Some of these may only be used during initial
|
|
|
|
configuration and further changes may need to be made in the generated
|
|
|
|
configuration files.
|
|
|
|
|
|
|
|
- ``FABRIC_VERSION``: Fabric Loader Version (*""*)
|
2022-02-16 23:16:51 -05:00
|
|
|
- ``MINECRAFT_VERSION``: Minecraft Version (*""*)
|
2020-08-15 17:55:59 -04:00
|
|
|
- ``JAVA_OPTS``: Java Commandline Arguments (*""*)
|
|
|
|
- ``MODPACK_NAME``: Modpack Name (*custom*)
|
|
|
|
- ``MODPACK_PUBLIC``: Modpack Download URL (*https://*``[SERVER_PUBLIC]``)
|
|
|
|
- ``PUID``: Mount Owner UID (*1000*)
|
|
|
|
- ``PGID``: Mount Owner GID (*100*)
|
|
|
|
- ``SERVER_NAME``: Server Name (*custom*)
|
|
|
|
- ``SERVER_PUBLIC``: Server IP/FQDN (*""*)
|
|
|
|
- ``TZ``: System Timezone (*America/New_York*)
|
|
|
|
|
|
|
|
## Persistent Mounts
|
|
|
|
|
|
|
|
You can provide a persistent mountpoint using the ``-v /host/path:/container/path``
|
|
|
|
syntax. These mountpoints are intended to house important configuration files,
|
|
|
|
logs, and application state (e.g. databases) so they are not lost on image
|
|
|
|
update.
|
|
|
|
|
|
|
|
- ``/mnt/config``: Persistent Data.
|
|
|
|
|
|
|
|
Do not share ``/mnt/config`` volumes between multiple containers as they may
|
|
|
|
interfere with the operation of one another.
|
|
|
|
|
|
|
|
You can perform some basic configuration of the container using the files and
|
|
|
|
directories listed below.
|
|
|
|
|
|
|
|
- ``/mnt/config/data/server/eula.txt``: Accept Minecraft EULA. [*]
|
|
|
|
- ``/mnt/config/data/server/server.properties``: Set Minecraft Properties. [*]
|
|
|
|
- ``/mnt/config/etc/crontabs/<user>``: User Crontabs. [*]
|
|
|
|
- ``/mnt/config/etc/logrotate.conf``: Logrotate Global Configuration.
|
|
|
|
- ``/mnt/config/etc/logrotate.d/``: Logrotate Additional Configuration.
|
|
|
|
- ``/mnt/config/www/minecraft/modpack/client/*``: Client-Side Optional Mods. [*]
|
|
|
|
- ``/mnt/config/www/minecraft/modpack/config/*``: Mod Configuration Files. [*]
|
|
|
|
- ``/mnt/config/www/minecraft/modpack/extract/*``: Modpack Zipfiles. [*]
|
|
|
|
- ``/mnt/config/www/minecraft/modpack/mods/*``: Minecraft Mods. [*]
|
|
|
|
- ``/mnt/config/www/minecraft/modpack/optional/*``: Optional Mods. [*]
|
|
|
|
- ``/mnt/config/www/minecraft/modpack/scripts/*``: Minecraft Tweaking Scripts. [*]
|
|
|
|
- ``/mnt/config/www/minecraft/modpack/server/*``: Server-Side Optional Mods. [*]
|
2020-08-15 19:20:03 -04:00
|
|
|
- ``/mnt/config/www/minecraft/modpack.xsl``: MCUpdater Modpack Theming. [*]
|
2020-08-15 17:55:59 -04:00
|
|
|
|
|
|
|
**[*] Changes to some configuration files may require service restart to take
|
|
|
|
immediate effect.**
|
|
|
|
|
|
|
|
## Network Services
|
|
|
|
|
|
|
|
This container runs network services that are intended to be exposed outside
|
|
|
|
the container. You can map these to host ports using the ``-p HOST:CONTAINER``
|
|
|
|
or ``-p HOST:CONTAINER/PROTOCOL`` syntax.
|
|
|
|
|
2023-05-09 16:08:19 -04:00
|
|
|
- ``25565/tcp+udp``: Minecraft Server. This is the game server.
|