Minecraft Bedrock Edition is the version of Minecraft that powers the iPhone / Android versions (formerly Minecraft Pocket Edition), the Xbox / PlayStation / Nintendo Switch editions and the free Windows 10 Minecraft edition.
Mojang has released a dedicated server which is considered to be in alpha testing. I have found it to be very stable and able to run on a wide variety of hardware.
This script and guide are written to help you get a robust Minecraft Bedrock dedicated server up and running in only a few minutes!
This is the standalone version. The easiest and most problem-free way to run this is using Docker (installed as simply as sudo apt install docker.io): Legendary Minecraft Bedrock Container
I’ve also released a way for Java and Bedrock players to play on the same server using Geyser: Minecraft Java + Bedrock Server Together – Geyser + Floodgate
It’s now possible to convert your worlds between Bedrock and Java versions. Check out my guide on Chunker here for more information.
Features
- Sets up the official Minecraft Bedrock Server (currently in alpha testing)
- Fully operational Minecraft Bedrock edition server in a couple of minutes
- Ubuntu / Debian distributions supported
- Sets up Minecraft as a system service with option to autostart at boot
- Automatic backups when server restarts
- Supports multiple instances — you can run multiple Bedrock servers on the same system
- Updates automatically to the latest or user-defined version when server is started
- Easy control of server with start.sh, stop.sh and restart.sh scripts
- Adds logging with timestamps to “logs” directory
- Optional scheduled daily restart of server using cron
Requirements
- A computer with a 64 bit processor (if you are trying to use ARM read my article on the limitations). 32 bit binaries of the official server are not available so it needs to be 64 bit!
- 1 GB of RAM or higher
- The only officially supported platform by Microsoft is Ubuntu 22.04 / 20.04 (current LTS, recommended)
- Other Linux flavors supported by this script as well as long as they use systemd (for the service). The script assumes apt is installed but there are minimal dependencies so you could install these on another distro (that doesn’t have apt present) and use the script normally.
Recommended Gear
Game Editions
Minecraft: Bedrock Edition is the “Windows 10” version of Minecraft as well as the version of Minecraft on the Xbox / Playstation / Switch. The versions of Minecraft for Android and iOS are also the Bedrock edition.
All of these versions support cross-platform play with each other (but not with the Java edition).
This is the PC Minecraft for Windows 10 (Bedrock) edition of Minecraft. It is able to play cross-platform with other players on Android / iOS / Playstation / Xbox / Switch. Available as a code that is instantly activated to give you permanent access to the game!
Links: Amazon.com*, Amazon.co.jp*, Amazon.co.uk*, Amazon.de*, Amazon.es*, Amazon.fr*, Amazon.it*
The Sony PlayStation version of Minecraft: Bedrock edition.
Links: Amazon.com*, Amazon.ca*, Amazon.com.au*, Amazon.co.jp*, Amazon.co.uk*, Amazon.de*, Amazon.es*, Amazon.fr*, Amazon.it*, Amazon.nl*, Amazon.se*, Amazon.sg*
This is the Nintendo Switch version of Minecraft: Bedrock edition.
Links: Amazon.com*, Amazon.ca*, Amazon.com.au*, Amazon.co.jp*, Amazon.co.uk*, Amazon.de*, Amazon.es*, Amazon.fr*, Amazon.it*, Amazon.nl*, Amazon.pl*, Amazon.se*, Amazon.sg*
This is the Microsoft Xbox version of Minecraft: Bedrock edition.
Links: Amazon.com*, Amazon.ca*, Amazon.com.au*, Amazon.co.uk*, Amazon.de*, Amazon.es*, Amazon.fr*, Amazon.it*, Amazon.nl*, Amazon.sg*
Recommended Storage (Solid State Drive)
I strongly recommend a Solid State drive (SSD) for your server. This is because Minecraft is constantly reading/storing chunks to the disk which makes I/O performance very important.
These are much cheaper than they used to be. Here’s a decent 120 GB one (higher capacity options are available) at a very low price:
The Kingston A400 is reliable, widely available around the world, has low power requirements and performs very well. It’s also very affordable. This drive has been benchmarked over 1000 times at Pi Benchmarks and is the #1 most popular SSD among the community!
Links: AliExpress*, Amazon.com*, Amazon.ca*, Amazon.com.au*, Amazon.co.jp*, Amazon.co.uk*, Amazon.de*, Amazon.es*, Amazon.fr*, Amazon.it*, Amazon.nl*, Amazon.pl*, Amazon.se*, Amazon.sg*
If you have a M.2 NVME slot in your motherboard you can go with a high end drive. This will give your server maximum performance even if a large number of players are running around on the server changing blocks and triggering disk writes.
This is the one I have in my machine. These range from 250 GB to 2 TB depending on how big your server might grow:
The Samsung 980 Pro (NVMe) is a professional grade SSD and one of the fastest in the world. The Samsung NVMe drives have been at the top of this category for a long time and are well trusted for both their performance and reliability / long life.
Links: AliExpress*, Amazon.com*, Amazon.ca*, Amazon.com.au*, Amazon.co.jp*, Amazon.co.uk*, Amazon.de*, Amazon.es*, Amazon.fr*, Amazon.it*, Amazon.nl*, Amazon.pl*, Amazon.se*, Amazon.sg*
Computer / CPU / Memory
Almost any PC made in the last few years will be a x86_64 bit computer. If you have an older computer around that isn’t being used then it will most likely have the right CPU and amount of memory (as well as fast storage) to run a basic server.
Throwing a SSD in one of these older computers will provide an excellent server experience for small and larger player counts.
The speed of your storage will make the largest difference. Older HDDs are going to have significantly slower performance than any modern SSD even with all other hardware equal. This is because the Minecraft server is constantly reading/writing chunks of your world as well as updates to it to the disk so this tends to be the bottleneck.
Operating System
I highly recommend using Ubuntu Server to run the Minecraft dedicated server. It is available here.
At the time of writing the current version is Ubuntu Server 20.04. This is a secure and robust operating system and will leave plenty of resources available for the server to run.
The script should run on any Debian based flavor of Linux but since the Minecraft Bedrock server is compiled natively for Ubuntu I recommend sticking with it. If you have a GUI flavor of Ubuntu and a decent PC (>= 2 GB of RAM) the server will work just fine on it.
Note: People have reported in the comments that Ubuntu 16.x is no longer working with the latest official Mojang binaries. Ubuntu 18.04 is the minimum requirement for the latest versions, and 20.04 is recommended!
Installation
Log into your Linux server either using SSH or a mouse and keyboard and paste/type the following command:
curl https://raw.githubusercontent.com/TheRemote/MinecraftBedrockServer/master/SetupMinecraft.sh | bash
The script will setup the Minecraft sever and ask you some questions on how to configure it. I’ll explain here what they mean.
The first question will be the installation path. This is the root installation path for ALL servers you will have. If you add additional servers later you should select the exact same installation path. It should always be left as the default (~).
The only exception is if you have something like a completely dedicated disk for the Minecraft server. In that case you should always use the same root path of /mnt/yourdrive or wherever the path is for every new/additional server you install.
“Start Minecraft server at startup automatically (y/n)?” – This will set the Minecraft service to start automatically when your server boots. This is a great option to set up a Minecraft server that is always available.
“Automatically restart and backup server at 4am daily (y/n)?” – This will add a cron job to the server that reboots the server every day at 4am. This is great because every time the server restarts it backs up the server and updates to the latest version. See the “Scheduled Daily Reboots” section below for information on how to customize the time or remove the reboot.
That is it for the setup script. The server will finish configuring and start!
First Run
The server will start up and start displaying output to the console.
[2019-03-30 20:25:12 INFO] Starting Server
[2019-03-30 20:25:12 INFO] Version 1.10.0.7
[2019-03-30 20:25:12 INFO] Level Name: Bedrock level
[2019-03-30 20:25:12 INFO] Game mode: 0 Survival
[2019-03-30 20:25:12 INFO] Difficulty: 1 EASY
[2019-03-30 20:25:20 INFO] IPv4 supported, port: 19132
[2019-03-30 20:25:20 INFO] IPv6 supported, port: 19133
[2019-03-30 20:25:23 INFO] Server started.
Once you see the “Server started” line you will be able to connect from the client.
To add the server to the client open Minecraft and click “Play”. Then at the top of the screen select the “Servers” tab and click “Add Server”.
This will ask you for a Server Name and Server IP Address. For the name you can put anything and for the server IP address put the address of your Linux server. Leave the port as the default 19132. For more information on how to let people from outside your network on go to the “Port Forwarding” section below.
Now choose the server you just added in the list and connect!
Start, Stop and Restart Server
The server can be started, stopped and restarted two different ways. You can use the provided scripts in the Minecraft folder or you can use systemctl. Here are the commands:
cd ~/minecraftbe ./start.sh ./stop.sh ./restart.sh -OR- sudo systemctl start minecraftbe sudo systemctl stop minecraftbe sudo systemctl restart minecraftbe
Automatic Backups
The server backs up each time it starts. This helps you recover easily if something goes wrong. This system works best if you configured the server to restart daily since it means you will have a backup every day.
To access these backups type:
cd ~/minecraftbe/backups
ls
When a backup is made the filename will be the date and time the backup was taken. If you need to restore a backup it’s very easy. Substitute the timestamp in my example to the backup you want to roll back to. Type:
cd ~/minecraftbe ./stop.sh rm -rf worlds tar -xf backups/2019.02.15.22.06.30.tar.gz ./start.sh
Your world has now been restored! It’s a good idea to download these backups off the server periodically just in case the server’s storage fails.
Installing Resource Packs / RTX Support
For instructions on how to install resource packs (including optional RTX support) view my step by step Minecraft Bedrock Dedicated Server Resource Packs guide here.
Scheduled Daily Reboots
The daily reboots are scheduled using cron. It’s very easy to customize the time your server restarts.
To change the time that the server restarts type: crontab -e
This will open a window that will ask you to select a text editor (I find nano to be the easiest) and will show the cronjobs scheduled on the server. The Minecraft one will look like the following:
0 4 * * * /home/ubuntu/minecraftbe/restart.sh
There are 5 fields here. The default restart time is set to reboot at 0 minutes of the 4th hour of the day (4 AM). The other 3 fields are left as * to represent every day of every month. Make any desired changes here and press Ctrl+X to exit nano and update the cronjob.
To remove the daily reboot simply delete the line and save.
Reconfigure / Update Scripts
The scripts can always be reconfigured and updated by downloading the latest SetupMinecraft.sh and running the installer again. It will update all of the scripts in the Minecraft directory and reinstall the startup service for you.
Running SetupMinecraft.sh again will also give you a chance to reconfigure options such as the memory dedicated to the server, daily reboots, starting the server on boot, etc.
This will not overwrite your world or any other data so it is safe to run!
Port Forwarding
If everyone on your server is on the same LAN or WiFi network as you then you don’t need to do this. If you want people to connect from outside your local network then you need to set up port forwarding on your router.
The process for this is different for every router so the best thing to do is just look at your router and find the model # and put that in google with port forwarding for easy instructions on how to do it for your specific router.
You want to forward port 19132. The type of connection is both TCP and UDP. On some routers you need to do both a TCP entry and then a second entry as UDP.
Once you do this people will be able to connect to your Minecraft server through your public IP address. This is different than your local IP which is usually a 192.x.x.x or 10.x.x.x. If you don’t know what that is just go to google and type “what’s my ip” and Google will kindly tell you!
Version Override
You can revert to a previous version with the revert.sh script included in your directory like this:
james@jamesgigabyte-linux:~/minecraftbe/james$ ./revert.sh Set previous version in version_pin.txt: bedrock-server-1.19.10.20.zip
If you have a specific version you would like to run you can also create version_pin.txt yourself like this:
echo "bedrock-server-1.18.33.02.zip" > version_pin.txt
The version hold can be removed by deleting version_pin.txt. This will allow it to update to the latest version again!
Wired vs. Wireless
Going with an ethernet (wired) connection is going to be faster and more reliable. There’s so much wireless traffic and other interference in the air that running your server on WiFi is not recommended.
Even if it is working great 99% of the time it can ruin your experience very quickly if the WiFi drops for a couple of seconds and you get blown up by a creeper!
All that being said, the server works fine on wireless. The script will work fine as is with a wireless connection.
Benchmarking / Testing Storage
If you’re getting poor performance you may want to run my storage benchmark with:
sudo curl https://raw.githubusercontent.com/TheRemote/PiBenchmarks/master/Storage.sh | sudo bash
PC results won’t show up on the site yet (it’s meant for Raspberry Pi) but it will run on Linux just fine and give you a score. If you search for the model of your drive on Pi Benchmarks you can compare your score with others and make sure the drive is performing correctly!
Troubleshooting Note – Oracle Virtual Machines
A 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.
It is because there are several steps you need to take to open the ports on the Oracle VM. You need to both:
- 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
Both 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.
I 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.
Troubleshooting Note – Hyper-V
There is a weird bug in Hyper-V that breaks UDP connections on the Minecraft server. The fix for this is that you have to use a Generation 1 VM with the Legacy LAN network driver.
Conclusion
The Minecraft Bedrock Edition dedicated server runs much better than previous third party servers in the past that were missing critical features. The performance is very good even on low end hardware. It has never been easier to set up a Minecraft Bedrock server.
If you have any feedback or suggestions let me know in the comment section. A lot of the changes and developments in this script and guide are directly from readers.
Have fun!
Other Resources
For a guide on how to set up resource packs check out my Minecraft Bedrock Resource Pack guide
If you’re trying to run this on the Raspberry Pi check out the Raspberry Pi specific guide here
Thanks for your hard work on this script. Two requests – make it escapable and put some warnings in the article here or in the script about running this on an existing Ubuntu system configured to do other things like host websites – the script automatically answered yes to apt commands that uninstalled about 80 critical packages on one of my web servers today.
Perhaps if apt plans to uninstall anything pause for user confirmation first?
Hey Jorus,
It shouldn’t be possible for the script to remove any packages. Only apt-get update and apt-get install are ran which are not supposed to remove any packages (that typically requires a dist-upgrade, remove or apt-get install –fix-broken in conjunction with the -y flag and usually even some other lower level apt/dpkg flags to get it to do this, it’s a pain to automate when you actually want it to do this!). Did you have a corrupt apt chain/conflict and then run a sudo apt install -f and then it uninstalled the 80 packages? I’d be really curious how this was managed by installing the basic dependencies in the script:
sudo apt-get update
sudo apt-get install screen unzip wget -y
sudo apt-get install net-tools -y
echo "Installing curl and libcurl.."
sudo apt-get install curl -y
sudo apt-get install libcurl4 -y
# Install libcurl3 for backwards compatibility in case libcurl4 isn't available
sudo apt-get install libcurl3 -y
echo "Installing openssl, libc6 and libcrypt1.."
sudo apt-get install openssl -y
sudo apt-get install libc6 -y
sudo apt-get install libcrypt1 -y
Frankly I’m not sure how a web server could be operational without 90% of these packages. Most systems already have them all and the check is mostly there to catch the most barebones out of the box systems that might be missing a few of them. I’m guessing it must have been a broken package/conflict here.
For the escapable characters piece I would not recommend using any character that would need to be escaped as input for any of the script’s fields. They’re used for folder names, file paths, in databases etc. and having anything that needs to be escaped is going to cause serious problems within the Bedrock server itself even if the script escapes the input. I thought about adding a regex to prevent people from trying to do this (just a simple alphanumerical check, I do believe spaces are allowed in Bedrock but I still wouldn’t recommend it) and maybe that’s still the best way to prevent this. We’ve definitely seen people have nasty problems before from unexpected characters in the input!
Do you have your logs for any of these apt activities? I’m absolutely willing to address this if I’m missing something here but I think there has to be more going on here (at the apt/system level). Let us know for sure!
Hi James,
once again it’s me. 😉
I’ve problems runnig the start.sh script, it always runns to a endless loop (I think) while checking the internet. It sleeps for over 6 hours at the point “Checking for the latest version of Minecraft Bedrock server …”
If I mark out the following block, the script works fine. Internet is reachable, I can make updates and downloads and so on. Do you have any sugestions for me?
# Test internet connectivity first
wget --quiet http://www.minecraft.net/ -O /dev/null
if [ "$?" != 0 ]; then
echo "Unable to connect to update website (internet connection may be down). Skipping update ..."
else
# Download server index.html to check latest version
wget -O downloads/version.html https://minecraft.net/en-us/download/server/bedrock/
DownloadURL=$(grep -o 'https://minecraft.azureedge.net/bin-linux/[^"]*' downloads/version.html)
DownloadFile=$(echo "$DownloadURL" | sed 's#.*/##')
# Download latest version of Minecraft Bedrock dedicated server if a new one is available
if [ -f "downloads/$DownloadFile" ]
then
echo "Minecraft Bedrock server is up to date..."
else
echo "New version $DownloadFile is available. Updating Minecraft Bedrock server ..."
wget -O "downloads/$DownloadFile" "$DownloadURL"
unzip -o "downloads/$DownloadFile" -x "*server.properties*" "*permissions.json*" "*whitelist.json*" "*valid_known_packs.json*"
fi
fi
Hey Matthias,
Welcome back! The latest version from GitHub and running SetupMinecraft.sh should do it for you as all of this has been recently fixed. Hopefully that helps!
Thanks James,
worked perfectly.
Hey Matthias,
That is excellent news, thanks for confirming! I recently fixed several issues with the auto updating and some long standing path issues that made people have to comment out the update check etc. since different operating systems had the binaries in different places and other small differences between systems. It’s definitely quite a bit more robust and hopefully will keep humming along for a while!
Hello James,
I installed a bedrock ubuntu dedicated server using your blog. My friend and I have a lot of fun together on my server.
I was wondering how to install a downloaded world map on this server. Could you provide some guidance?
Hey Michel,
On the default installation the world files will just be in the “world” folder. It depends on how the person packaged the map for download. Most of the time it should just be a folder in there that you can extract to your Minecraft folder.
It’s safe to create a blank test installation with the server and try extracting the contents of the world download into your Minecraft folder. Definitely let us know what you find and I can assist further!
Hey James,
I don’t know if this is related to the other problems recently posted, but I accidentally left my laptop unplugged and it died while running the server. Once I booted up the laptop again, I was dismayed to see there was no screen to be resumed after typing screen -r. I knew this meant something went wrong and after restarting my laptop a couple times amongst other this I tried to update SetupMinecraft.sh (keep in mind I have no idea what I’m doing). I don’t know if I needed to remove my old SetupMinecraft.sh but I just ran./SetupMinecraft.sh and let everything download. Now after it finishing it said Starting Minecraft Server… After nothing happened for a while (also through this I’ve periodically checked to see if the server was working on Minecraft) I tried -screen r again. The same message as before popped up. Don’t know if I’m doing something wrong?
Thanks,
Jacob
Hey Jacob,
That sounds like something else is going on with it if it was starting to do this from before the updates. If the server was working before though the good news is we’re likely to have useful log files in the “logs” directory. Let’s go ahead and open that up and see what you’re getting.
I’ve seen this be things like an “entity” getting corrupted inside the server that after removing everything works normally again etc. I am going to update the script to look for these log files and display them to help make these easier to diagnose for sure as sometimes the log messages are pretty clear about what it wants you to do to “fix” it! Can you take a look and let us know what you see?
Ok so would I cd to “logs” and if so what should I type / do after that? Sorry not very good at this yet.
Hey Jacob,
No problem! Once you’re in the logs folder just look for the latest file and you can display it by typing “cat thefile.log”.
I also added a new feature last night to the fixpermissions.sh script. You’ll have to run SetupMinecraft.sh again to get the updated version (make sure you download the newest SetupMinecraft.sh from GitHub first) but after the update if you run fixpermissions.sh it will tell you the last 5 log entries now! To run the script go to your server folder and type:
sudo ./fixpermissions.sh
and let us know what you find!
Great news! After updating to the most recent SetupMinecraft.sh it worked without having to run fixpermissions.sh. Thanks!
Hey Jacob,
That’s fantastic news! I made a bunch of fixes a few days ago and I’m guessing it was wrapped up in that. Keep enjoying!
Since last night update the server was starting anymore. After commenting out the check for update & download new version code in start.sh the server was able to start again.
Can you fix this in next update?
Hey Mario,
Thanks for this. My best guess is that something has been tweaked with the update server (this has happened before unfortunately, the script used to use the –robots flag until they started blocking robots). Maybe now they’re even checking user agents on connections to the update server to make sure it’s actually “Chrome” or something would be my off the top of the head guess. I’m guessing Gary’s issue is related to this as well.
I’ll definitely check it out and get a patch up!
Yeah, same glitch for me (./start.sh does the backup no problem but then get’s stuck when checking for a new version). I appleid the same work around for now (i.e i used nano editer to insert a # in front of the lines related to checking for an update). The server launches correctly now.
Hey Hobes128,
Awesome, I am glad you found the workaround. I just committed a fix if you’d like to give it a try from GitHub (download an updated SetupMinecraft.sh first)!
Have not been able to restart server, nor creating new server for that matter. systemctl status said “Failed with result ‘timeout'”
Hey Gary,
That’s a little bit stranger one I haven’t seen for a while. What happens when you try running the server manually from the command line? To do that you go to your minecraft server folder and type this weird command directly on the command line from inside your server folder:
LD_LIBRARY_PATH=. ./bedrock_server
That will let us see what is happening directly since you’re launching the server yourself instead of letting the systemctl service launch it. It could be something like a missing dependency that we aren’t seeing but this trick should reveal it. It’s possible there’s a log file in the “logs” folder as well, but it’s hard to say if it’s getting far enough to generate any useful output before locking up or stopping.
Sometimes if the system thinks the service has been modified it might just need a:
sudo systemctl daemon-reload
and then try starting the service again. I’ve seen that end up being the problem once or twice for this and then it started right up after that!
Can you give those a try and let us know what you find?
Using bedrock_server command line works. I can also reproduce the behavior Mario reported: It’s stuck at “check for update”
Hey Gary,
Thanks for the additional info! Can you go ahead and try with the latest version? I think I’ve got this all fixed up here.
Hi James,
I downloaded the latest version and it’s working for me as far as I can tell. Thanks for fixing it so quickly!!
Hey Gary,
I’m relieved to hear that, thanks for letting me know!
Thanks, this guide and your scripts helped me get a Minecraft server running on Ubuntu in Azure!
One thing I don’t understand now that I have the server running is how I get back into the Minecraft command console.
In ubuntu terminal, I can see that my minecraft service is running using systemctl list-units –type=service
But I don’t know how to interact with the terminal to run commands like change game mode, add whitelist user etc
This is probably a really basic linux question, I just dont even know how to google for it 😮
Hey HenrikF,
No worries! The easiest way is to type:
screen -r
That will bring up all the hidden “screen” windows like the Minecraft console on your server. Hopefully that helps!