How to Install Minecraft (Java) Server on Your Synology NAS with Docker

Last updated on May 9th, 2023 at 10:45 am

A Minecraft (Java) server is a dedicated server that allows multiple players to play the popular sandbox video game Minecraft together over a network connection. Minecraft servers can be set up either on a local machine or a remote machine, such as a cloud server or a dedicated server.

The server software runs on the Java platform and provides a persistent virtual world that can be customized and populated with various game elements, such as terrain, buildings, and creatures. Players can connect to the server and interact with each other and the world in real-time, building structures, exploring, and surviving.

There are many different types of Minecraft servers, including survival servers, creative servers, and PvP (player versus player) servers, each with its own set of rules and objectives.

Overall, a Minecraft (Java) server provides a platform for players to collaborate and play Minecraft together, and can be a fun and rewarding experience for both the server administrator and the players.

In this guide I will show you how to set up your very own Minecraft Java Server. This edition will not work with consoles such as the Nintendo Switch or Mobile/Cell phone Apps. You can find out more information about the Java edition here.

Want the Minecraft Bedrock Edition instead? click here.

Code Source: GitHub / Plugins: Here

Skip to Compose & Portainer Code / Skip to Install Plugins

Install Docker

Before we start, please ensure you have Docker installed. This can be installed through the Synology Package Center.

Install Portainer

For this guide we’re going to use Portainer. If you have not yet installed Portainer, please follow this easy install guide. Portainer will keep our install quick and straight forward.

Create Docker Folders

We now need to create the Minecraft Docker folder. Head into File Station and open the Docker folder. Select Create, choose Create folder and name it minecraft_bukkit. Inside this folder, we will now create two more directories, name these data and plugins. (see demonstration)

Open Portainer

Open Portainer. If you have used my previous guide, you can locate your container here http://synologyip:9000. If you have not yet installed Portainer, please follow this easy install guide

Add stack

From the menu to the left, click into Stacks. From the Stacks page, click on Add stack.

From the Create stack screen, under Name, enter ‘minecraft_bukkit‘. Make sure that you are also in the Web editor tab, there will be a tick to show this.

Copy and past the full code from below to the Web editor box.

Important: Ensure you update the code to reflect your details. If you know what you are doing, you can change the other options to suit. For more configuration options see this link.

version: "3.8"

    image: itzg/minecraft-server
    container_name: minecraft_bukkit
      - /volume1/docker/minecraft_bukkit/data:/data
      - /volume1/docker/minecraft_bukkit/plugins:/plugins
      - 25565:25565
      EULA: "TRUE"
      TYPE: "BUKKIT"
      DIFFICULTY: "normal"
      GAMDEMODE: "Creative"
      OPS: "YourMinecraftUsername"
      SERVER_NAME: "TheMightyOne"
      MOTD: "Welcome to my Minecraft Server"
      MEMORY: "4G"
      JVM_XX_OPTS: "-XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:+AlwaysPreTouch -XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4 -XX:G1MixedGCLiveThresholdPercent=90 -XX:G1RSetUpdatingPauseTimePercent=5 -XX:SurvivorRatio=32 -XX:+PerfDisableSharedMem -XX:MaxTenuringThreshold=1 -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=8M -XX:G1ReservePercent=20 -XX:InitiatingHeapOccupancyPercent=15"
    tty: true
    stdin_open: true
    restart: unless-stopped

From the bottom of the page, click on ‘Deploy the stack‘.

If successful, you should have a Stack successfully deployed message. The installation process has now finished. Give it a few minutes to appear in your Docker list.

Once installed you may notice a high CPU and RAM usage, this should hopefully settle down after a few minutes.

Desktop App

Open minecraft and select Multiplayer. Click Add Server. Enter a Server Name, followed by your Server Address. This will be synologyip:25565. Press Done. Now join your server.

Install Plugins

Head over to the plugins website. When the page loads you’ll need to change the Game Version to match the version you just installed, this will show you the compatible plugins with your version. Installing an incompatible plugin may cause the game to not load.

Important: Be mindful when upgrading Minecraft to the latest version. The upgraded version may not be compatible with your currently installed plugins. It’s always good practice to check and re-download your favourite plugins before you upgrade.

Once you find the plugin you want, click Download.

Save the file to your desktop. Once saved, go back to your Synology NAS and head into File Station and open the Docker folder. Go into minecraft_bukkit. Now click into plugins. Drag the plugin you downloaded into this folder. Restart your Minecraft container. That’s it, job done!

More Guides:

Actual AdGuard airsonic Audiobookshelf autobrr Bitcoin Calibre-Web ChatpadAI Cleanarr Composerize Crypto DailyTxT Dashy deemix Deluge Emby EmulatorJS Ethereum Euterpe FileBot FilePizza FileZilla Flame Focalboard FreshRSS Grafana Grocy Heimdall Homarr Home Assistant Homebridge Jackett Jellyfin Jellyseerr Joplin Kavita Komga LanguageTool LibreOffice Lidarr Mealie MediaGoblin Medusa Memegen Minecraft Minecraft Bedrock MQTT MusicBrainz MyMediaForAlexa Navidrome Node-RED NZBGet NZBHydra Ombi Overseerr PaperlessNGX Pashword Password Cards Petio Pi-Hole Picard Plex Portainer PostgreSQL Prowlarr PUID & PGID pwndrop Radarr Radicale Readarr ruTorrent SABnzbd SearX Seed Phrase Shiori Sonarr SpeedTest Stash Storm Tailscale TasmoAdmin Tautulli Theia Trilium TubeSync Unpackerr Uptime Kuma Vaultwarden Watchtower WebPDF Whisparr Wordle YouTubeDL

Leave a Comment

Scroll to Top