[{"_1":2,"_172":-5,"_173":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_148":149},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_139":-5,"_140":11,"_141":17,"_142":11,"_143":-5,"_144":11,"_145":-5,"_146":147},"canonicalUrl","https://hub.docker.com/r/marcelmaatkamp/minecraft-docker/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","marcelmaatkamp","reponame","minecraft-docker","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":-5,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2023-06-09T19:55:11.803956Z","description","","is_private","last_updated","2023-06-10T09:53:11.778055Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.oci.image.index.v1+json","name","pull_count",482,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# Legendary Java Minecraft + Geyser + Floodgate + Paper Dedicated Server for Docker\n\n# This has a discordbot embeded into it which allows people to turn on and off the server at will. This is designed for me and my friends and I will not support this container for anyone else.\n\n $\"Legendary$ \n\nThis is the Docker containerized version of my Minecraft Java Paper Dedicated Server for Linux/Raspberry Pi scripts but with Geyser and Floodgate included.\n\nGeyser and Floodgate allow Minecraft Bedrock players to join your Java server!\n\nMy main blog article (and the best place for support) is here.
\nThe version without Floodgate and Geyser is here.
\nThe official GitHub repository is located here.
\nThe official Docker Hub repository is located here.
\n
\nThe Bedrock version of the Docker container is available here. This is for Java Minecraft but Bedrock players can connect to it.
\n \n

Features

Sets up fully operational Minecraft server that allows both Java and Bedrock clients to connect
Runs the highly efficient \"Paper\" Minecraft server
Runs Geyser to allow Bedrock clients to connect and Floodgate to allow them to authenticate with their Bedrock credentials to a Java server
Uses named Docker volume for safe and easy to access storage of server data files (which enables more advanced Docker features such as automatic volume backups)
Plugin support for Paper + Spigot + Bukkit
Installs and configures OpenJDK 18
Automatic backups to minecraft/backups when server restarts
Updates automatically to the latest version when server is started
Runs on all Docker platforms including Raspberry Pi
Runs on all Kubernetes platforms including Raspberry Pi

\n\n\n

Docker Usage

\nFirst you must create a named Docker volume. This can be done with:
\n

docker volume create yourvolumename

\n\nNow you may launch the server and open the ports necessary with one of the following Docker launch commands:
\n
\nWith default ports:\n

docker run -it -v yourvolumename:/minecraft -p 25565:25565 -p 19132:19132/udp -p 19132:19132 --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest

\nWith custom ports (this example uses 12345 for the Java port and 54321 for the Bedrock port):\n

docker run -it -v yourvolumename:/minecraft -p 12345:12345 -e Port=12345 -p 54321:54321/udp -p 54321:54321 -e BedrockPort=54321 --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest

\nWith a custom Minecraft version (add -e Version=1.X.X, must be present on Paper's API servers to work):\n

docker run -it -v yourvolumename:/minecraft -p 25565:25565 -p 19132:19132/udp -p 19132:19132 -e Version=1.17.1 --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest

\nWith a maximum memory limit in megabytes (optional, prevents crashes on platforms with limited memory, -e MaxMemory=2048):\n

docker run -it -v yourvolumename:/minecraft -p 25565:25565 -p 19132:19132/udp -p 19132:19132 -e MaxMemory=2048 --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest

\nUsing a different timezone:\n

docker run -it -v yourvolumename:/minecraft -p 25565:25565 -p 19132:19132/udp -p 19132:19132 -e TZ=\"America/Denver\" --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest

\nSkipping backups on certain folders (comma separated):\n

docker run -it -v yourvolumename:/minecraft -p 25565:25565 -p 19132:19132/udp -p 19132:19132 -e NoBackup=\"plugins/ftp,plugins/test2\" --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest

\nSkipping permissions check:\n

docker run -it -v yourvolumename:/minecraft -p 25565:25565 -p 19132:19132/udp -p 19132:19132 -e NoPermCheck=\"Y\" --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest

\n\n

Kubernetes Usage

\nFirst you must create a suitable PVC using your preferred StorageClass.
\nTo run within Kubernetes, you must pass the enviroment variable `k8s=\"True\"`\nalongside any others you require:
\n

\n        env:\n        - name: MaxMemory\n          value: '1024'\n        - name: TZ\n          value: Europe/London\n        - name: k8s\n          value: \"True\"\n

\nBe aware that terminal features will not be available when running in kubernetes\n
\nThe pod can be exposed using a LoadBalancer or TCP/UDP Ingress service. See example manifests in the /kubernetes folder of the repo. The examples are based on Longhorn\nstorage backend and a LoadBalancer service - these will need altering to be suitable\nfor your environment.
\n\n

Configuration / Accessing Server Files

\nThe server data is stored where Docker stores your volumes. This is typically a folder on the host OS that is shared and mounted with the container.
\nYou can find your exact path by typing:

docker volume inspect yourvolumename

This will give you the fully qualified path to your volume like this:\n

{\n        \"CreatedAt\": \"2022-05-09T21:08:34-06:00\",\n        \"Driver\": \"local\",\n        \"Labels\": {},\n        \"Mountpoint\": \"/var/lib/docker/volumes/yourvolumename/_data\",\n        \"Name\": \"yourvolumename\",\n        \"Options\": {},\n        \"Scope\": \"local\"\n    }

\n
\nOn Linux it's typically available at:

/var/lib/docker/volumes/yourvolumename/_data

\nOn Windows it's at

C:\\ProgramData\\DockerDesktop

but may be located at something more like

\\wsl$\\docker-desktop-data\\version-pack-data\\community\\docker\\volumes\\

if you are using WSL (Windows Subsystem for Linux
\n
\nOn Mac it's typically

~/Library/Containers/com.docker.docker/Data/vms/0/

\nIf you are using Docker Desktop on Mac then you need to access the Docker VM with the following command first:\n

screen ~/Library/Containers/com.docker.docker/Data/com.docker.driver.amd64-linux/tty

\nYou can then normally access the Docker volumes using the path you found in the first step with docker volume inspect

\nMost people will want to edit server.properties. You can make the changes to the file and then restart the container to make them effective.
\n
\nBackups are stored in the \"backups\" folder
\n
\nThe Geyser configuration is located in plugins/Geyser-Spigot/config.yml
\nThe Floodgate configuration is located in plugins/floodgate/config.yml
\n\n

TZ (timezone) Environment Variable

\nYou can change the timezone from the default \"America/Denver\" to own timezone using this environment variable:

docker run -it -v yourvolumename:/minecraft -p 25565:25565 -p 19132:19132/udp -p 19132:19132 -e TZ=\"America/Denver\" --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest

\nA list of Linux timezones is available here\n\n

BackupCount Environment Variable

\nBy default the server keeps 10 rolling backups that occur each time the container restarts. You can override this using the BackupCount environment variable:

docker run -it -v yourvolumename:/minecraft -p 25565:25565 -p 19132:19132/udp -p 19132:19132 -e BackupCount=20 --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest

\n\n

QuietCurl Environment Variable

\nYou can use the QuietCurl environment variable to suppress curl's download output. This will keep your logs tidier but may make it harder to diagnose if something is going wrong. If things are working well it's safe to enable this option and turn it back off so you can see the output if you need to:

docker run -it -v yourvolumename:/minecraft -p 25565:25565 -p 19132:19132/udp -p 19132:19132 -e QuietCurl=Y --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest

\n\n

Plugins

\nThis is a \"Paper\" Minecraft server which has plugin compatibility with Paper / Spigot / Bukkit.
\n
\nInstallation is simple. There is a \"plugins\" folder on your Docker named volume.
\n
\nNavigate to your server files on your host operating system (see accessing server files section if you don't know where this is) and you will see the \"plugins\" folder.
\n
\nYou just need to drop the extracted version of the plugin (a .jar file) into this folder and restart the container. That's it!
\n
\nSome plugins have dependencies so make sure you read the installation guide first for the plugin you are looking at.
\nA popular place to get plugins is: https://dev.bukkit.org/bukkit-plugins\n\n

Troubleshooting Note - Oracle Virtual Machines

\nA very common problem people have with the Oracle Virtual Machine tutorials out there that typically show you how to use a free VM is that the VM is much more difficult to configure than just about any other product / offering out there.
\nThe symptom you will have is that nobody will be able to connect.
\nIt is because there are several steps you need to take to open the ports on the Oracle VM. You need to both:
\n

Set the ingress ports (TCP/UDP) in the Virtual Cloud Network (VCN) security list
*and* set the ingress ports in a Network Security Group assigned to your instance

\nBoth of these settings are typically required before you will be able to connect to your VM instance. This is purely configuration related and has nothing to do with the script or the Minecraft server itself.

\nI do not recommend this platform due to the configuration difficulty but the people who have gone through the pain of configuring an Oracle VM have had good experiences with it after that point. Just keep in mind it's going to be a rough ride through the configuration for most people.

\nHere are some additional links:
\n

https://jamesachambers.com/official-minecraft-bedrock-dedicated-server-on-raspberry-pi/comment-page-8/#comment-13946
https://jamesachambers.com/minecraft-bedrock-edition-ubuntu-dedicated-server-guide/comment-page-53/#comment-13936
https://jamesachambers.com/minecraft-bedrock-edition-ubuntu-dedicated-server-guide/comment-page-49/#comment-13377
https://jamesachambers.com/legendary-minecraft-bedrock-container/comment-page-2/#comment-13706

\n\n

Troubleshooting Note - Hyper-V

\nThere is a weird bug in Hyper-V that breaks UDP connections on the Minecraft server. There are two fixes for this. The simplest fix is that you have to use a Generation 1 VM with the Legacy LAN network driver.
\nSee the following links:
\n

https://jamesachambers.com/minecraft-bedrock-edition-ubuntu-dedicated-server-guide/comment-page-54/#comment-13863
https://jamesachambers.com/minecraft-bedrock-edition-ubuntu-dedicated-server-guide/comment-page-56/#comment-14207

\nThere is a second fix that was shared by bpsimons here.
You need to install ethtool first with sudo apt install ethtool. Next in your /etc/network/interfaces file add \"offload-tx off\" to the bottom as the issue appears to be with TX offloading.
\nHere's an example:

# The primary network interface\nauto eth0\niface eth0 inet static\naddress 192.168.1.5\nnetmask 255.255.255.0\nnetwork 192.168.1.0\nbroadcast 192.168.1.255\ngateway 192.168.1.1\noffload-tx off

\nThis can also be done non-persistently with the following ethtool command:

ethtool -K eth0 tx off

\n\n

Buy A Coffee / Donate

People have expressed some interest in this (you are all saints, thank you, truly)

PayPal: 05jchambers@gmail.com
Venmo: @JamesAChambers
CashApp: $theremote
Bitcoin (BTC): 3H6wkPnL1Kvne7dJQS8h7wB4vndB9KxZP7

\n\n

Update History

April 18th 2023

Add NoViaVersion environment variable to disable using ViaVersion in case of incompatible plugins

March 25th 2023

Migrate paper.yml to paper-global.yml (thanks karl007, Issue #21)

March 16th 2023

Update to Paper 1.19.4

March 15th 2023

Add ViaVersion plugin to allow players on newer clients to connect to the server (very helpful when waiting for new updates to be released)
Fix Geyser and Floodgate update checks

January 25th 2023

Removed check for terminal and will let the Minecraft server throw an error if environment is not appropriate

January 14th 2023

Change google.com connectivity change to papermc.io as Google is blocked in some countries causing the connectivity check to fail when a connection to papermc.io would have succeeded (thanks Misakaou, Issue #14

January 12th 2023

Remove broken ScheduleRestart environment variable -- this needs to be done in your OS using docker restart (typically with crontab in Linux or Task Scheduler in Windows)

December 7th 2022

Update to 1.19.3 (thanks WarpOverload, issue #9)

November 19th 2022

Add \"QuietCurl\" environment variable which will suppress the progress meter on curl keeping the logs much tidier (thanks willman42, PR #6
Remove fixpermissions.sh and add 3 lines into main start.sh file

November 7th 2022

Fail immediately if ran without an interactive terminal (as the Minecraft server won't work without one)

October 30th 2022

Add RISC architecture support
Switch from ubuntu:latest to ubuntu:rolling
Switch from using Adoptium to using ubuntu:rolling OpenJDK
Removed SetupMinecraft.sh
Fix bug with new ScheduleRestart environment variable

October 21st 2022

Added new environment variable \"BackupCount\" to control the number of backups the container keeps
NoBackup optional environment variable can now be multiple paths to files to skip backups on separated by a comma. Example: plugins/test,plugins/test2

October 20th 2022

Added new environment variable \"NoBackup\" to skip a folder from backup activities
Added new environment variable \"NoPermCheck\" to skip permissions check during startup
Added new environment variable \"ScheduleRestart\" -- this schedules the container to shut down at a certain time which combined with the --restart switch gives daily reboot functionality

October 8th 2022

Upgrade to OpenJDK 19

September 27th 2022

Fix SIGTERM catching in certain situations by running java with the \"exec\" command which passes execution completely to that process (thanks vp-en)
Remove screen dependency

September 20th 2022

Fixed Geyser update code (thanks vp-en)
Update to OpenJDK 18.0.2.1

August 29th 2022

Add environment variables section to docker-compose.yml template
Add optional TZ environment variable to set timezone

August 28th 2022

Additional fix for #2 by adding a default config.yml for the server to use for Geyser (thanks vecnar, issue #2)

August 27th 2022

Fix broken Geyser-Spigot config.yml issue (thanks vecnar, issue #2)

August 22nd 2022

Add NoScreen environment variable -- disables screen which prevents needing an interactive terminal (but disables some logging)
Fix issue #1 (thanks Sam7, issue #1)

August 18th 2022

Test rolling back OpenJDK version slightly to earlier version of OpenJDK 18 previous to 10th-11th gen Intel CPU bugs

August 17th 2022

Add XX:-UseAESCTRIntrinsics to java launch line to prevent encryption issue on 10th Gen Intel processors

August 10th 2022

Adjust query.port in server.properties to be the same as the main server port to keep the \"ping port\" working properly
Add enforce-secure-profile=false to default server.properties to prevent login errors
Add text editor inside the container (nano) for diagnostic/troubleshooting purposes

August 6th 2022

Initial release

\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",2359434912,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_97":98,"_46":128,"_129":90,"_130":29,"_131":52,"_53":132,"_133":134,"_135":105,"_136":128,"_137":62,"_138":17},"content_type","creator",16442,"digest","sha256:2eeac55a38ca7fee0829b9a3e5df1cc9e2b74d7ec00afbfb5ccd4dc7a3492ec4","full_size",362059324,"id",454955981,"images",[99,114,120,125],{"_100":101,"_91":102,"_103":44,"_104":105,"_106":107,"_108":109,"_110":44,"_111":-5,"_112":94,"_59":62,"_113":-5},"architecture","amd64","sha256:d241b8afe07c075fa34f62a641e9786cecc1bc46ccade9575416234e19d0a8b3","features","last_pulled","2026-09-21T17:35:38.980806393Z","last_pushed","2023-06-10T09:53:12Z","os","linux","os_features","os_version","size","variant",{"_100":115,"_91":116,"_103":44,"_104":117,"_106":118,"_108":109,"_110":44,"_111":-5,"_112":119,"_59":62,"_113":-5},"arm64","sha256:fea4ad46782979fe36d2346fde6c2ef2f1ce6a9750dc6adb2aea89db9f1df767","2026-09-19T12:30:53.240789152Z","2023-06-10T09:53:11Z",348944529,{"_100":121,"_91":122,"_103":44,"_104":123,"_106":118,"_108":121,"_110":44,"_111":-5,"_112":124,"_59":62,"_113":-5},"unknown","sha256:7d21fbd4cb10df8b1a20912f5970b632a0e9d8974c5864969263798c04de2c93","2026-09-19T12:30:53.223918697Z",27626,{"_100":121,"_91":126,"_103":44,"_104":127,"_106":107,"_108":121,"_110":44,"_111":-5,"_112":124,"_59":62,"_113":-5},"sha256:bb22c55f167d32e5726ddc42bbed44a3cfa1102296b43136ac1321dda38ddd3f","2026-09-19T12:30:53.244985941Z","2023-06-10T09:53:11.532085Z","last_updater","last_updater_username","media_type","latest","repository",20230231,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":150,"_157":158,"_146":170,"_171":11},{"_36":151,"_38":152,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":153,"_53":31,"_28":29,"_54":55,"_56":-5,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":154,"_75":11,"_76":156,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":155},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_159":60,"_160":-5,"_161":-5,"_162":163},"count","next","previous","results",[164],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_97":165,"_46":128,"_129":90,"_130":29,"_131":52,"_53":132,"_133":134,"_135":105,"_136":128,"_137":62,"_138":17},[166,167,168,169],{"_100":101,"_91":102,"_103":44,"_104":105,"_106":107,"_108":109,"_110":44,"_111":-5,"_112":94,"_59":62,"_113":-5},{"_100":115,"_91":116,"_103":44,"_104":117,"_106":118,"_108":109,"_110":44,"_111":-5,"_112":119,"_59":62,"_113":-5},{"_100":121,"_91":122,"_103":44,"_104":123,"_106":118,"_108":121,"_110":44,"_111":-5,"_112":124,"_59":62,"_113":-5},{"_100":121,"_91":126,"_103":44,"_104":127,"_106":107,"_108":121,"_110":44,"_111":-5,"_112":124,"_59":62,"_113":-5},[],"canDeleteTags","actionData","errors"]

Digest	OS/ARCH	Compressed size
d241b8afe07c	linux/amd64	345.29 MB
fea4ad467829	linux/arm64	332.78 MB

marcelmaatkamp/minecraft-docker

Tags for marcelmaatkamp/minecraft-docker