Minecraft Server Docker Setup (MACOS) 2025

MINECRAFT.md

Gist Overview: Setup a Minecraft Server in Docker on MacOS (2025)

---

Java Edition Setup
Compatibility: Windows, Mac

# Download the image
docker pull itzg/minecraft-server
# Create and navigate to local folder. Example:
cd ~/MINECRAFT/JAVA

# Initialize new container for the edition you downloaded
# Vanilla
docker run -d -it -v $(pwd):/data --name minecraft-java -p 25565:25565 -e EULA=TRUE itzg/minecraft-server
# With performance mods and version isolation
docker run -d -it -v $(pwd):/data --name minecraft-26.1.2 -p 25565:25565 -e EULA=TRUE -e TYPE=FABRIC -e VERSION=26.1.2 -e MODRINTH_PROJECTS_DEFAULT_VERSION_TYPE=beta -e MODRINTH_PROJECTS="alternate-current,ferrite-core,krypton,lithium" itzg/minecraft-server

# Get server IP Address (Mac)
ipconfig getifaddr en0
# In Mincraft Client (on local network)
# Play -> Multiplayer -> Direct Connect -> IP Address
# Access the container  (CTRL+D to escape)
docker exec -it minecraft-java /bin/bash
# Open server commands prompt (CTRL+C to escape)
rcon-cli
# Make admin user (commands can now to be used in-game)
op USERNAME

---

Bountiful Farming Server Mod
Uses Forge with Minecraft Version 1.20.1

# Download and install curseforge client app
# Search for Bountiful Farming -> Install

# Download the image
docker pull itzg/minecraft-server
# Create and navigate to local folder. Example:
cd ~/MINECRAFT/JAVA
# Initialize new container for the edition you downloaded
docker run -d -it -v $(pwd):/data --name minecraft-1.20.1-bountiful-farming -p 25565:25565 -e EULA=TRUE -e TYPE=FORGE -e VERSION=1.20.1 -e MODRINTH_DOWNLOAD_DEPENDENCIES=required -e MODRINTH_PROJECTS_DEFAULT_VERSION_TYPE=beta -e MODRINTH_PROJECTS="ferrite-core,canary" itzg/minecraft-server

# In Curseforge -> Right click Bountiful Farming -> Open Folder
# In /mods, select all server-only jar files and copy them to the server's mod folder
# Restart container
# Optional: add the connectivity mod to server manually to suppress FML server error
# -> https://www.curseforge.com/minecraft/mc-mods/connectivity/files/7366161
# Optional: remove fancymenu mod from client because its buggy

# Get server fingerprint
docker exec -it minecraft-1.20.1-bountiful-farming /bin/bash
# Open Minecraft commands
rcon-cli
# Copy the fingerprint and share
/automodpack host fingerprint

---

Generate a New World

1. Stop container
2. Rename `MINECRAFT/world` to a backup name
3. Create a new `MINECRAFT/world` directory
4. Start container