docker-minecraft

Docker image for (vanilla) Minecraft server.

MIT License

Stars
8

docker-minecraft


Running the Container

First create a named data volume to hold the persistent world and config data:

docker volume create --name minecraft-data

Then run the Minecraft server:

docker run -it -d -p 25565:25565 -v minecraft-data:/etc/minecraft --name minecraft-server phlak/minecraft

Optional 'docker run' Arguments

NOTE: See the Minecraft Wiki for more info on memory requirements.

Editing the Server Config

Once you have a running container, you can edit the Minecraft server config with:

docker exec -it minecraft-server vi /etc/minecraft/server.properties

After saving changes, restart your container with docker restart minecraft-server

Adding OPs

Once you have a running server container you can add OPs by running:

docker exec minecraft-server ops [PLAYER_NAMES]

NOTE: Replace [PLAYER_NAMES] with the name of one or more players you wish to give OP privileges separated by a space. If a players name contains spaces wrap it in quotation marks.

Here's an example granting OP to three players with name's Marty, Jennifer and Doc Brown:

docker exec minecraft-server ops Marty Jennifer "Doc Brown"

Running Server Commands

You can run commands on the server (e.g. kick, ban, say, etc.) by attaching to the running container and running the commands. Attach to the server by running:

docker attach minecraft-server

Once attached you can run your commands like normal.

say Hello world!
[10:11:56] [Server thread/INFO]: [Server] Hello world!
list
[10:12:08] [Server thread/INFO]: There are 3 of a max 10 players online: Marty, Jennifer, Doc Brown
seed
[10:12:19] [Server thread/INFO]: Seed: [-5234790158571010769]

NOTE: In order to detach from the container and leave it running use the Ctrl + P then Ctrl + Q key sequence.

Upgrading the Server

First pull down the latest image:

docker pull phlak/minecraft

Remove your running server container:

docker rm -f minecraft-server

And run a new one with the same command/arguments as before.

Troubleshooting

For general help and support join our GitHub Discussions or reach out on Twitter.

Please report bugs to the GitHub Issue Tracker.

Copyright

This project is licensed under the MIT License.

Related Projects