From b446d4cc3feef6bb5780762073374c65b4737abf Mon Sep 17 00:00:00 2001 From: Geoff Bourne Date: Sun, 18 Jul 2021 16:19:57 -0500 Subject: [PATCH] docs: added recommendation of management layer --- README.md | 25 +++---------------------- 1 file changed, 3 insertions(+), 22 deletions(-) diff --git a/README.md b/README.md index 31aa7ecf..72d67250 100644 --- a/README.md +++ b/README.md @@ -13,30 +13,11 @@ To simply use the latest stable version, run docker run -d -it -p 25565:25565 -e EULA=TRUE itzg/minecraft-server -where the standard server port, 25565, will be exposed on your host machine. +where, in this case, the standard server port 25565, will be exposed on your host machine. -If you want to serve up multiple Minecraft servers or just use an alternate port, -change the host-side port mapping such as +> If you plan on running a server for a longer amount of time it is highly recommended using a management layer such as [Docker Compose](#using-docker-compose) or [Kubernetes](#deployment-templates-and-examples) to allow for incremental reconfiguration and image upgrades. - ... -p 25566:25565 ... - -will serve your Minecraft server on your host's port 25566 since the `-p` syntax is -`host-port`:`container-port`. - -Speaking of multiple servers, it's handy to give your containers explicit names using `--name`, such as naming this one "mc" - - ... --name mc itzg/minecraft-server - -With that you can easily view the logs, stop, or re-start the container: - - docker logs -f mc - ( Ctrl-C to exit logs action ) - - docker stop mc - - docker start mc - -> Be sure to always include `-e EULA=TRUE` in your commands, as Mojang/Microsoft requires EULA acceptance. +> Be sure to always include `-e EULA=TRUE` in your commands and container definitions, as Mojang/Microsoft requires EULA acceptance. By default, the container will download the latest version of the "vanilla" [Minecraft: Java Edition server](https://www.minecraft.net/en-us/download/server) provided by Mojang. The [`VERSION`](#versions) and the [`TYPE`](#server-types) can be configured to create many variations of desired Minecraft server.