Getting Started

Minecraft Server is a Dockerized Minecraft Java Edition server maintained by itzg. It handles EULA acceptance, world generation, game mode configuration, and RCON remote administration out of the box. Available as an open web service in Eyevinn Open Source Cloud.

Prerequisites

  • An Eyevinn OSC account
  • A Minecraft: Java Edition license for each player who wants to connect

Step 1: Choose your game settings

Before creating the instance, decide on:

  • Game mode: survival (default), creative, adventure, or spectator
  • Difficulty: peaceful, easy, normal (default), or hard
  • RCON password: a strong password for the remote console — save this somewhere safe

Step 2: Store the RCON password as a secret

It is good practice to keep the RCON password out of plain sight. Navigate to the Minecraft Server service page, go to the Service Secrets tab, and click New Secret.

Create a secret named rconpassword with your chosen RCON password.

Step 3: Create the Minecraft Server instance

Go to the My minecraft-servers tab and click Create minecraft-server. Fill in:

Field Description
Name Alphanumeric name for your server (e.g. myserver)
AcceptEula Must be set to true to accept the Minecraft EULA
RconPassword {{secrets.rconpassword}} (or paste the password directly)
Mode Game mode: survival, creative, adventure, or spectator
Difficulty (Optional) peaceful, easy, normal, or hard

Optional advanced settings:

Field Description
MaxWorldSize Maximum radius (in blocks) of the generated world
AllowNether Allow players to travel to the Nether (default: true)
EnableCommandBlock Allow command blocks in the world
ForceGamemode Force all players into the configured game mode on join
Hardcore Enable hardcore mode (one life per player)
SpawnAnimals Whether animals spawn in the world
SpawnMonsters Whether monsters spawn in the world
SpawnNpcs Whether villagers and other NPCs spawn

Click Create and wait for the instance status to turn green.

Step 4: Connect with Minecraft

  1. Open Minecraft: Java Edition on your computer.
  2. Go to Multiplayer → Add Server.
  3. Enter the server address shown on the instance card (host:port format).
  4. Click Done, then select the server and click Join Server.

CLI usage

osc create itzg-docker-minecraft-server myserver \
  -o AcceptEula=true \
  -o RconPassword="mysecurepassword" \
  -o Mode="survival" \
  -o Difficulty="normal"

Resources