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.

  16. I would also motivate just about every person to save this web page for any favorite assistance to assist posted the appearance.
    Mobdro APK iOS

  17. If your looking for Online Illinois license plate sticker renewals then you have need to come to the right place.We offer the fastest Illinois license plate sticker renewals in the state.
    Azar unlimited Gems APK

  18. Always so interesting to visit your site.What a great info, thank you for sharing. this will help me so much in my learning
    ludo star apk download for ios

  19. Great tips and very easy to understand. This will definitely be very useful for me when I get a chance to start my blog.
    GTA 5 apk download

  20. I like viewing web sites which comprehend the price of delivering the excellent useful resource free of charge. I truly adored reading your posting. Thank you!
    Showbox APK Latest Version

  21. Thanks for this great post. Download nova launcher app from: nova launcher prime apk

  22. I am a new user of this site so here i saw multiple articles and posts posted by this site,I curious more interest in some of them hope you will give more information on this topics in your next articles.
    Planet Bomber APK for PC Download

  23. I have been searching to find a comfort or effective procedure to complete this process and I think this is the most suitable way to do it effectively.
    Minecraft Story Mode iOS

  24. ses is being matched by the improvements in technology. What was state of the art just 2 years ago is being trashed by gamers for the newest and greatest gaming systems.

  25. We are really grateful for your blog post. You will find a lot of approaches after visiting your post. Great work
    The Best Sims 4 Mods Download for PC

  26. i am Glad Very detailed post on wonderful ideas. It would be really pangu android for more info samsung blocked by frp Thanks for sharing. Really appreciate it.

  27. Now you can win free stuff online, free giveaways, enter every day to win latest iphones, smartphones, macbooks, laptops, accessories, technology and much more.

    Participate, Win & Keep A Free Apple iPhone X

  28. This is really awesome, am so glad to read this informative article. I must confess this one of the exceptional blog that I have ever come across. Keep sharing this kind of information to users.

    I'm a freelancer by profession, I can help you write a blog post on any nich, incase you may need a professional writing service, here are some of my articles:
    Quick tips on Email marketing tips,
    Best free music download sites get high quality mp3 audios,
    Download AnonyTun Pro Apk best free vpn for Android,
    Best places to Watch Hindi movies online free,
    Best 17 GameCube ROMS for Dolphin Emulator,
    A professional tips on How to write a cover letter,
    Ultimate guide to Human resource management,
    Best websites to download free movie,
    Abokifx today's Black market Naira to Dollar exchange rate,
    Best working iptv m3u playlist url to watch live iPTV channels free on Kodi and Roku
    Do you need my service?

  29. Thanks for this wonderful post also you can learn how to get spotify premium free to listen latets music tracks.

  30. GBWhatsapp apk Download Latest Version 2018. Download Latest GB Whatsapp for Use 2 Whatsapp in One Mobile.  GBWhatsApp App

  31. Softofree
    Get your favorite mac & windows applications on your computer or macbook. Free games & applications are available here to download

  32. GBWhatsapp apk Download Latest Version 2018. Download Latest GB Whatsapp for Use 2 Whatsapp in One Mobile.  GBWhatsApp App

  33. I would like to thank you for thestruggle you have made in writing this article. I am hoping the same best work from you in the future as well. In fact your creative writing abilities has inspired me to start my own Blog Engine blog now. Really the blogging is escalationits wings rapidly.
    Gta 5 apk data files download

  34. I am really enjoying reading your well written articles. It looks like you spend a lot of effort and time on your blog. I Additionally large amounts of dazzling encounters can be given to people when you wouldn't dare hoping anymore this is the way it's believed extremel extraordinarily
    splendid. People can appreciate the diversion when you want as this amusement needs.
    Roblox Apk Download