{"id":16362449,"url":"https://github.com/petemcw/docker-minecraft-server","last_synced_at":"2026-05-10T05:16:02.978Z","repository":{"id":139038590,"uuid":"51621461","full_name":"petemcw/docker-minecraft-server","owner":"petemcw","description":"Docker container for Minecraft","archived":false,"fork":false,"pushed_at":"2016-11-24T16:43:14.000Z","size":9,"stargazers_count":1,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-05-29T15:14:49.230Z","etag":null,"topics":["docker","docker-image","minecraft","minecraft-server","unraid"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/petemcw.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-02-12T22:44:01.000Z","updated_at":"2022-06-12T14:21:57.000Z","dependencies_parsed_at":"2023-06-25T22:43:48.651Z","dependency_job_id":null,"html_url":"https://github.com/petemcw/docker-minecraft-server","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/petemcw/docker-minecraft-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petemcw%2Fdocker-minecraft-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petemcw%2Fdocker-minecraft-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petemcw%2Fdocker-minecraft-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petemcw%2Fdocker-minecraft-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/petemcw","download_url":"https://codeload.github.com/petemcw/docker-minecraft-server/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petemcw%2Fdocker-minecraft-server/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266430671,"owners_count":23927166,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","docker-image","minecraft","minecraft-server","unraid"],"created_at":"2024-10-11T02:24:16.638Z","updated_at":"2026-05-10T05:16:02.936Z","avatar_url":"https://github.com/petemcw.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# petemcw/docker-minecraft-server\n\nBecause its fun and my kids love it, this is a Docker image for a vanilla Minecraft server.\n\n![](https://raw.githubusercontent.com/petemcw/docker-templates/master/petemcw/img/minecraft-banner.png)\n\n## Usage\n\nTo quickly get the latest stable version of Minecraft up and running, the following will get you started:\n\n```\ndocker run -d --name=minecraft_server \\\n    -p 25556:25556 \\\n    -v /src \\\n    -e PUID=\u003cuid\u003e \\\n    -e PGID=\u003cgid\u003e \\\n    -e EULA=true \\\n    -e DEFAULT_OP=\u003cname\u003e \\\n    petemcw/docker-minecraft-server\n```\n\n### Required Startup Variables\n\nMojang requires you to agree to their [Minecraft EULA](https://account.mojang.com/documents/minecraft_eula). If you don't pass an acceptance variable the container will not start.\n\nI am also requiring at least a single administrator to be specified. You can pass in a single username or a comma-separated list.\n\n```bash\nDEFAULT_OP=petemcw,\u003csome_other_admin\u003e\n```\n\n## Versions\n\nThe container will default to the latest stable release. You can change the version used by specifying one of three values:\n\n* `latest` -- most recent stable release\n* `snapshot` -- most recent release\n* `1.x.x` -- specific version number, such as `1.8.9`\n\nFor example to run the latest, bleeding-edge version:\n\n```bash\ndocker run -d -e VERSION=snapshot ...\n```\n\n## Server Configuration (Environment Variables)\n\nThe image uses environment variables to alter the configuration of the Minecraft server and Java settings. The most common settings are highlighted below but any of the options from `server.properties` can be adjusted.\n\n### EULA\n\nThe variable `EULA` is required when creating a new container. Mojang requires that you agree before Minecraft can be run.\n\n### Default OP\n\nThe variable `DEFAULT_OP` is required when creating a new container. Any usernames specified in the variable will be added to the `ops.json` file.\n\n### Java Options\n\nYou can adjust the JVM settings by altering what is defined in the `JAVA_OPS` variable. This is useful for settings things like Java's memory limit.\n\n### Minecraft Home\n\nThe default location for `MINECRAFT_HOME` is `/src`, which is also a volume. All Minecraft related artifacts go here. To add mods, backup your world data, or make other changes to your server you must connect to your server container and make changes in this directory.\n\n### Message of The Day\n\nYou can adjust the message that is shown below each server entry in the Minecraft UI by changing the `MOTD` variable.\n\nTo use spaces in the message you will need to quote the whole variable like so:\n\n```bash\ndocker run -d -e \"MOTD=Best Server Ever\"\n```\n\n### World Name\n\nYou can switch between worlds or run multiple servers with different worlds by changing the value of the `LEVEL_NAME` variable.\n\n### Seed\n\nYou can create your Minecraft world using a specific seed by passing the value within the `LEVEL_SEED` variable.\n\nA few cool options are:\n\n* `4031384495743822299`\n* `69160882195`\n\n### Difficulty\n\nThis image defaults the Minecraft difficulty to normal. You can change the difficulty by switching the `DIFFICULTY` variable. The possible options are:\n\n* `0` -- Peaceful\n* `1` -- Easy\n* `2` -- Normal\n* `3` -- Hard\n\n### Game Mode\n\nThe default game mode for Minecraft is survival. You can change the mode by altering the `GAMEMODE` variable. The possible options are:\n\n* `0` -- Survival\n* `1` -- Creative\n* `2` -- Adventure\n* `3` -- Spectator (version 1.8 or later)\n\n### PVP\n\nThe default setting is for the player-vs-player (PVP) mode to be enabled. You can disable this functionality by setting the `PVP` variable to `false`.\n\n### `server.properties`\n\nFor reference, here is a list of the variables that can be set for use with generating a `server.properties` file:\n\n* ALLOW_FLIGHT\n* ALLOW_NETHER\n* ANNOUNCE_PLAYER_ACHIEVEMENTS\n* DIFFICULTY\n* ENABLE_COMMAND_BLOCK\n* ENABLE_QUERY\n* ENABLE_RCON\n* FORCE_GAMEMODE\n* GAMEMODE\n* GENERATE_STRUCTURES\n* GENERATE_SETTINGS\n* LEVEL_NAME\n* LEVEL_SEED\n* LEVEL_TYPE\n* MAX_BUILD_HEIGHT\n* MAX_PLAYER\n* MAX_TICK_TIME\n* MAX_WORLD_SIZE\n* MOTD\n* NETWORK_COMPRESSION_THRESHOLD\n* ONLINE_MODE\n* OP_PERMISSION_LEVEL\n* PLAYER_IDLE_TIMEOUT\n* PVP\n* RESOURCE_PACK\n* RESOURCE_PACK_SHA1\n* SERVER_IP\n* SERVER_PORT\n* SNOOPER_ENABLED\n* SPAWN_ANIMALS\n* SPAWN_MONSTERS\n* SPAWN_NPCS\n* USE_NATIVE_TRANSPORT\n* VIEW_DISTANCE\n* WHITE_LIST\n\n## Data Volume\n\nThis image has a single volume defined, `/src`. This volume contains all the Minecraft server and world data. You can learn more about how to [manage data within a volume at Docker](https://docs.docker.com/engine/userguide/containers/dockervolumes/).\n\n## Docker Compose\n\nThis is the preferred way for managing your containers boots your Minecraft server with a data volume container to make sure your data is persisted.\n\nAssuming you have Docker Compose installed, you need to have a `docker-compose.yml` file with your container details:\n\n```bash\nminecraft:\n  image: petemcw/minecraft-server\n  ports:\n    - \"25565:25565\"\n  volumes_from:\n    - minecraft_data\n  restart: always\n  environment:\n    - ADVANCED_DISABLEUPDATES=true\n    - PUID=501\n    - PGID=20\n    - EULA=true\n    - DEFAULT_OP=petemcw\n\nminecraft_data:\n  image: tianon/true\n  volumes:\n    - /src\n```\n\nUsing the example above, to launch your Minecraft server and persist your data:\n\n```bash\ndocker-compose up -d minecraft\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpetemcw%2Fdocker-minecraft-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpetemcw%2Fdocker-minecraft-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpetemcw%2Fdocker-minecraft-server/lists"}