Wednesday, July 1, 2015

Synology NAS Minecraft Server Administration

Update: I will be maintaining the following page with the most up to date information:

Last month I wrote a post about how I modified a package to install a basic Minecraft server onto my Synology NAS.  Once you run the package your server will be running with default settings.  If you're like me, the question is, "Uh, now what?"  When I picked up the project, I knew exactly nothing about administering a Minecraft server, so I have been stumbling through this.

So, first a little primer, without any extensions, a Minecraft server will be a single world, either creative or survival.  The settings for the server will be in /volume1/@appstore/Minecraft/

Command Line:

You can telnet or SSH into your Synology once you've turned on the Terminal service in "Control Panel-> Terminal & SNMP -> Terminal -> Enable Telnet/SSH service." Once you log in with your client of choice you can manually edit this file using VI.  This is, of course, how I did it at first. If you're not used to using a Linux command line and/or you've never used VI, that will quite likely be a painful experience.  Even if you used to use VI a bit but that was 20 years ago, you're going to struggle a bit.  A few client options:

  • Windows includes a telnet client.
  • Lots of people like PuTTY.

Synology DSM Interface

Unfortunately, DSM (currently 5.2) doesn't have a built-in way to easily deal with editing your config files.  Fortunately, there are third party solutions!  There is a "config file editor" package linked below:

I've gone ahead and hosted this in my repository for convenience.  NOTE:  You must have Synology's Perl package installed for this to work, so install it first if you don't already have it installed.

Once you have it installed (you can run it from the Package Center), you can open it and set it up to edit your Minecraft config files.  Under "Choose config file" select "Config File Editor" and add the following lines:

/volume1/@appstore/Minecraft/,Minecraft-properties /volume1/@appstore/Minecraft/white-list.txt,Minecraft-whitelist /volume1/@appstore/Minecraft/ops.txt,Minecraft-ops

I added them at the top of the list, right below the row of # signs, since they were the main files I wanted to edit with this utility.  Now you'll have to close down config file editor and restart, and voila, you'll have access to your important files.  This won't get you away from using a command line, but it will get you away from VI.

When you add names to the ops.txt and the white-list.txt files, Minecraft will import them on startup, and rename the .txt files to .txt.converted.  The actual data will be stored in similarly named .JSON files that will have the UID's associated with each user name, like this:

    "uuid": "xxxxx-xxx-xxxxx-xxxx",
    "name": "username"

Once you're up and running, as an op you can whitelist people from the in-game command line and not worry about editing these files.

To Be Continued

I will come back and edit this as I have a chance.


Below are some useful Minecraft Server Admin Links:


  1. hi mate i put this on the main forum but still having trouble connecting to the server, if i go to info center it tells me its running no no conection to the lan which is possibly the reason why i can't connect to it, any ideas or anything i can try ?

  2. My bukkit dont want to start !! help me please

  3. Hi Colin,

    Craftbukkit is not installing correctly here. How can I investigate ?
    Have you ever searched a solution to administrate your syno minecraft server with a gui ?


  4. I tried it but it's not working at Minecraft Hosting. Can you give me a solution.

  5. Very good commands, thank y very much.

    Best regards
    Toby, due diligence data room

  6. How are you installing mods? I am not a command line wiz, but notice with the newer DSM, they lock down SSH to root. Is there any way to open up visibility into the @appstore to make it easier to do mod management? I assume configuration, mods, and saves all live in @appstore/minecraft or @appstore/spigot (depending on variation)?

    1. You can open things up -- see the updated page:

  7. Thanks. For some reason, when I've done the package and run the install through DSM, it lists as installed yet I do not see any files in the @appstore/minecraft directory other than minecraft.jar. As a Mac user and someone who runs a Minecraft server on my Mini, I recognize where to put mods saves etc. I also created a startup file (start.command). So my questions are:

    1. How to start the minecraft server? (Do you do simply through the DSM package)
    2. Where do mods etc. live?

  8. This Blog was a really helpfull for me to set up the server. I have one server running on a DS216j and i can access this within my network. But i still have a problem with access from outside my network. Portforwarding on 25565 in my router is on but still cant access it. Any ideas???

  9. Hello Colin
    Thx you for your piece of code : great !
    But i'm a newbie and i don't understand how to configure the server to enable WAN players to access to my server (sorry for my so bad english, i'm french...). Do you have already written some tutorials ? Many thx

  10. Hello Colin
    Thx you for your piece of code : great !
    But i'm a newbie and i don't understand how to configure the server to enable WAN players to access to my server (sorry for my so bad english, i'm french...). Do you have already written some tutorials ? Many thx

  11. Very Well-Written Content. I found this blog unique and what i have been looking for, many thanks. Indian Independence Day SMS Happy Independence

  12. This is very educational content and written well for a change. It's nice to see that some people still understand how to write a quality post! fnaf world update 3

  13. I just expectation that the gaming organizations focus on this and understand that they are making pretending games for part players and in the event that they're not in the market for part players, at that point they should call their games by an alternate class.Unblocked Games Free

  14. Thank you because you have been willing to share information with us. we will always appreciate all you have done here because I know you are very concerned with our. games like minecraft

  15. I found numerous awesome highlights which can make my abilities more good one. Visit Here It has an attractive sensor which can without much of a stretch give me the execution like I am playing a genuine plane since it has joystick catches which required weight like genuine plane.