myferr/mc-server repository overview

⁠🐳 mc-server

Minecraft servers in Docker

• Prebuilt Docker images for multiple Minecraft versions
• Minimal Docker Compose setup
• Quick startup and ready-to-play

⁠Quick Start

⁠Pull & Run with Docker

docker run -d -p 25565:25565 --name mc-server myferr/mc-server:1.21.6

⁠Minimal Docker Compose

services:
  mc-server:
    image: myferr/mc-server:1.21.6
    container_name: mc-server
    ports:
      - "25565:25565"

Start the server:

docker compose up -d

⁠Configuration

You can configure the Minecraft server through environment variables in either docker run or docker-compose.yml.

⁠Supported Variables

⁠Server icons

A Minecraft server icon is a visual representation of the game's logo or a custom design that can be used to identify the server in the server list, to apply the logo to the server just by placing it in the server-icon.png⁠ file in the server directory. Make sure it's a .png and a 64x64 pixel size.

To apply a server icon in your Docker Compose add the following lines:

    volumes:
      - ~/desktop/server-icon.png:/server/server-icon.png

Full example:

services:
  mc-server:
    image: myferr/mc-server
    container_name: mc-server
    ports:
      - "25565:25565"
    volumes:
      - ~/desktop/server-icon.png:/server/server-icon.png

⁠Docker Run

docker run -d -p 25565:25565 \
  -e MOTD="Welcome to my server!" \
  -e DIFFICULTY=normal \
  -e GAMEMODE=survival \
  -e HARDCORE=false \
  myferr/mc-server:latest

⁠Docker Compose

services:
  mc-server:
    image: myferr/mc-server:latest
    ports:
      - "25565:25565"
    environment:
      - DIFFICULTY=normal
      - MOTD=Welcome to my server!
      - GAMEMODE=survival
      - HARDCORE=false

⁠Supported Versions

⁠License

This project is licensed under the MIT license and is completely open-source.