Minecraft Bedrock Edition – Ubuntu Dedicated Server Guide

Minecraft Bedrock Edition Logo
Minecraft: Bedrock Edition Logo

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!


  • Sets up fully operational Minecraft Bedrock edition server in a couple of minutes
  • Ubuntu / Debian distributions supported
  • Fully operational Minecraft Bedrock edition server in a couple of minutes
  • 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 version when server is started
  • Easy control of server with start.sh, stop.sh and restart.sh scripts
  • Optional scheduled daily restart of server using cron

UPDATE 12/10/20 – Multiple instances are currently broken due to the Minecraft Bedrock Edition dedicated server opening up a set of ports it is not supposed to. Official bug is here on Mojang’s official website. This should fix itself eventually as it has nothing to do with this script but is in fact a bug in the server itself but for now be advised multiple instances don’t work. Single instances of the server are still fine.


  • 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
  • Ubuntu Server 20.04 / 18.04

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).

Minecraft for Windows 10

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.in*, Amazon.it*

Minecraft for Xbox

This is the Microsoft Xbox version of Minecraft: Bedrock edition.

Links: Amazon.ae*, Amazon.ca*, Amazon.com*, Amazon.com.au*, Amazon.com.mx*, Amazon.co.uk*, Amazon.de*, Amazon.es*, Amazon.fr*, Amazon.in*, 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:

Kingston A400
Kingston A400 2.5″ SATA SSD

The Kingston A400 has been a great drive to use for years. It’s 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 pibenchmarks.com and is the #1 most popular SSD!

Links: AliExpress.com*, Amazon.ae*, Amazon.ca*, Amazon.com*, Amazon.com.au*, Amazon.com.mx*, Amazon.co.jp*, Amazon.co.uk*, Amazon.de*, Amazon.es*, Amazon.fr*, Amazon.in*, Amazon.it*, Amazon.nl*, Amazon.pl*, Amazon.sa*, 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:

Samsung 970 EVO NVMe SSD
Samsung 970 EVO Plus NVMe SSD

The Samsung 970 EVO Plus is a fantastic drive and has fallen in price substantially. It’s widely available around the world. The smaller capacities (such as the 250GB version) of this drive are perfect! This is the top performance option without going into the “Pro” series of the lineup which are much more expensive.

Links: AliExpress.com*, Amazon.ae*, Amazon.ca*, Amazon.com*, Amazon.com.au*, Amazon.com.mx*, Amazon.co.jp*, Amazon.co.uk*, Amazon.de*, Amazon.es*, Amazon.fr*, Amazon.in*, Amazon.it*, Amazon.nl*, Amazon.pl*, Amazon.sa*, 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: https://ubuntu.com/download/server

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!


Log into your Linux server either using SSH or a mouse and keyboard and paste/type the following command:

wget https://raw.githubusercontent.com/TheRemote/MinecraftBedrockServer/master/SetupMinecraft.sh
chmod +x SetupMinecraft.sh

The script will setup the Minecraft sever and ask you some questions on how to configure it. I’ll explain here what they mean.

“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
[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


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

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
rm -rf worlds
tar -xf backups/2019.

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
Crontab's syntax layout
Crontab’s syntax layout

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!

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.


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!

581 thoughts on “Minecraft Bedrock Edition – Ubuntu Dedicated Server Guide”

  1. Avatar for Michel Pelletier
    Michel Pelletier

    Hello James, thanks for your work. I installed a minecraft server on my computer to play with a friend. It worked great until today. Minecraft updated so I could nolonger connected to my “outdated server”. I tried updating the server with a stop and restart but the server no longer starts. I get ” /bin/bash: /home/maison/minecraftbe/thomas/bedrock_server: Permission denied” in the log file. Any ideas why?

    1. Avatar for jamesachambers

      Hey Michel,

      That’s interesting that JD had the exact same issue posted as you only minutes apart! Check out my reply here for the same instructions:


      It sounds like either the update is changing the file owner or it’s potentially still in use as a stuck process somewhere. Try the steps I recommended in the reply above and let me know!

  2. Avatar for JD Benoit

    I’m dumb and did not shut down the server correctly. I didn’t use ./stop.sh to stop the Minecraft server and restarted the server. Now when I try to start the Minecraft server using ./start.sh or sudo ./start.sh it looks like Minecraft server is starting but it doesn’t start. The log file that is created shows the location of the server and Permission denied. Any idea on how to fix this?

    1. Avatar for jamesachambers

      Hey JD,

      That sounds for sure like a permissions issue. I have a script in the Minecraft server folder called fixpermissions.sh or you can run:

      sudo chown -R youruser ~/minecraftbe

      That will take ownership of all the files for you! Make sure you restart the computer too to make sure nothing is in use as well but that should take care of it. Give it a try and let us know!

      1. Avatar for JD Benoit

        Hey James,
        I modified the permission, which weren’t an issue before, and restarted and still get the same cycle. I wonder if the patch they release today broke the BDS…

        1. Avatar for ALTELMA

          Yep +1, I think the root cause from new BD server I try to load and run by my self not running and got error permission when I was trying to run it.

          1. Avatar for jamesachambers

            Hey Altema,

            Thanks for the heads up. It almost sounds like something is wrong with the server if you can’t even run it manually from the command line. I should be able to test the latest version tomorrow morning and see if I can find a fix or find out what is going on!

        2. Avatar for jamesachambers

          Hey JD,

          It sounds like from how many others are having issues that something bigger is going on. I’m going to test everything tomorrow and investigate what is going on and if there is an easy fix. They may also release an update to fix it at any moment but it sounds like even running the server from the CLI still gives permission errors.

          1. Avatar for dangle

            after seeing this, i tried removing ‘/bin/bash …. LD_LIBRARY_PATH…’ from the game launch command in start.sh and no longer got the error but the game never started, only the screen session.
            then i realized what had bad permissions on it, bedrock_server itself no longer had execute permissions.
            reverted start.sh to it’s original state, chmod +x bedrock_server and she started right up!

            1. Avatar for JD Benoit

              That worked!!! You all are awesome!! Does anyone know what would have changed the permission?
              James you are amazing for setting this up. Dangle you are amazing for finding this issue.

  3. Avatar for Al

    Hi James, love the script and it’s largely working fine. However, I’m getting an error that I think is related to PAM:

    When the server is restarted using restart.sh manually (or via the cron job), the server script comes up fine but the service then fails. Logs show this error occuring at the same time as the restart: pam_unix(sudo:auth): auth could not identify password for [localaccountusername].

    Any thoughts?

    1. Avatar for jamesachambers

      Hey AI,

      That is a little bit more of an unusual one! Did you set a password for localaccountusername? I would try running the passwd command on that account (even if it already has a password set just set it again) and see if it can clear that error. Best I can tell is this error occurs when “null” passwords are trying to be passed to PAM.

      It could also be your local user account isn’t added to the sudoers group potentially and it may be running a “sudo” command in the script. You can try adding your account into /etc/sudoers as well to see if that clears it!

      1. Avatar for dangle

        same issue here.

        Apr 06 23:39:52 bedrockdmz sudo[3661]: bedrock : TTY=pts/0 ; PWD=/home/bedrock ; USER=root ; COMMAND=/usr/bin/systemctl status BedrockDMZ
        Apr 06 23:39:52 bedrockdmz sudo[3661]: pam_unix(sudo:session): session opened for user root by bedrock(uid=0)
        Apr 06 23:39:52 bedrockdmz systemd[1]: Configuration file /etc/systemd/system/BedrockDMZ.service is marked executable. Please remove executable permission bits. Proceeding anyway.
        Apr 06 23:39:52 bedrockdmz sudo[3661]: pam_unix(sudo:session): session closed for user root
        Apr 06 23:39:56 bedrockdmz multipathd[659]: sda: add missing path
        Apr 06 23:39:56 bedrockdmz multipathd[659]: sda: failed to get udev uid: Invalid argument
        Apr 06 23:39:56 bedrockdmz multipathd[659]: sda: failed to get sysfs uid: Invalid argument
        Apr 06 23:39:56 bedrockdmz multipathd[659]: sda: failed to get sgio uid: No such file or directory

          1. Avatar for dangle

            no joy

            — Reboot —
            Apr 07 00:45:25 bedrockdmz sudo[891]: pam_unix(sudo:auth): Couldn’t open /etc/securetty: No such file or directory
            Apr 07 00:45:25 bedrockdmz bash[891]: sudo: a terminal is required to read the password; either use the -S option to read from standard input or configure an askpass helper
            Apr 07 00:45:25 bedrockdmz sudo[891]: pam_unix(sudo:auth): conversation failed
            Apr 07 00:45:25 bedrockdmz bash[884]: Backing up server (to minecraftbe/BedrockDMZ/backups folder)
            Apr 07 00:45:25 bedrockdmz sudo[891]: pam_unix(sudo:auth): auth could not identify password for [bedrock]

            this is all i find in the instance log
            /bin/bash: /home/bedrock/minecraftbe/BedrockDMZ/bedrock_server: Permission denied

      2. Avatar for Al

        Confirmed: user account is in the sudoers group.
        Password is set on the account (and it fails after a reset also).

        Just tried the script on a clean install of linux too – same error. Looks like something’s been changed with PAM in the past week or two that’s crippled the script; it was running beautifully until quite recently.

        1. Avatar for Al

          pam_unix(sudo:auth): conversation failed
          pam_unix(sudo:auth): auth could not identify password for [myusername]

          lilyland.service – lilyland Minecraft Bedrock Server
          Loaded: loaded (/etc/systemd/system/lilyland.service; enabled; vendor preset: enabled)
          Active: failed (Result: exit-code) since Wed 2021-04-07 16:57:10 BST; 4min 10s ago
          Process: 15696 ExecStartPre=/bin/chown -R $myusername /home/$myusername/minecraftbe/lilyland (code=exited, status=0/SUCCESS)
          Process: 15697 ExecStart=/bin/bash /home/$myusername/minecraftbe/lilyland/start.sh (code=exited, status=0/SUCCESS)
          Process: 15720 ExecStop=/bin/bash /home/$myusername/minecraftbe/lilyland/stop.sh (code=exited, status=1/FAILURE)

          1. Avatar for Al

            Found where one issue is triggered by the startup script; it’s your network detection check; commenting that out allows it to run.

            The other is the line to take permission of the folders; that’s the one that’s triggering the PAM request (& only instance of sudo that I can find).

            Running the fixpermissions.sh script once to set the permissions straight after running the install script and then commenting out the line in start.sh is a workaround.

      1. Avatar for Wook


        Thank you so much for making minecraft install so easy. I have used it a number of times so far.

        I don’t really know what I am doing, just following your scripts.
        I installed it again yesterday, so that I could have a fresh world, and got the following error:

        Setup is complete. Starting Minecraft server…
        Job for WookNew.service failed because the control process exited with error code.
        See “systemctl status WookNew.service” and “journalctl -xe” for details.
        Minecraft server failed to start after 20 seconds.
        There is no screen to be resumed matching WookNew.

        I had said yes to auto backup and to auto restart.
        I do have version installed from the minecraft.net website, but that was not running when your version was installed.

        I am using an old-ish PC, now with Groovy Gorilla.


        1. Avatar for jamesachambers

          Hey Wook,

          I’m guessing if this is a older PC and this is happening that you are running a 32 bit OS (i386) instead of a 64 bit OS (x86_64).

          Unfortunately Mojang has never released the Bedrock server in 32 bit and attempts to use emulation have been really slow/unstable. Can you confirm if this is the case? If you type:

          uname -a

          It should tell you whether it’s i386 or x86_64!

          1. Avatar for Wook

            Thank you for your reply.

            this is what it returns:
            Linux ubuntu2 5.8.0-48-generic #54-Ubuntu SMP Fri Mar 19 14:25:20 UTC 2021 x86_64 x86_64 x86_64 GNU/Linux

            It used to run Windows Home Premium 64bit, with an Intel core i5 2310

            I shall try reinstalling your version, because now that I have dropped back to using the version from Minecraft.net, the whole system fails every day, and I have to press the power button for 6 seconds to stop/start it again.


            1. Avatar for Wook

              no luck.

              How do I uninstall the server?
              So far I have renamed minecraftbe to …._old, but I still get the same error.


              1. Avatar for jamesachambers

                Hey Wook,

                The only piece of the server to uninstall if you have moved/remove the folder is a service in /etc/systemd/system/yourservername.service. You can do a sudo rm /etc/systemd/system/yourservice.service to remove that and that is the only piece that is outside the folder. The scripts don’t do too much other than run the bedrock_server executable (more on that at the end of the post) / do updates / some housekeeping. If you didn’t select “y” to the question during setup on whether to start the server automatically this service may not exist (it’s not required).

                If the OS is freezing it sounds like it may need a OS reinstall of Ubuntu potentially. Your architecture is right (x86_64 instead of i386) so that definitely looks good. The server executable is a pretty large binary (executable file) from Mojang that is mostly statically linked but it has a few minor dependencies that could possibly be broken on that system. OpenSSL is one dependency but it should be installed by default (unless something has broken). An out of the box install should work just fine with the script though as it will install any of these dependencies for you. Are you seeing any errors when running the setup script that it couldn’t install something?

                Have you tried running the server manually without the scripts to see if the executable can run? The instructions to do that are on the Minecraft Dedicated Server download page at https://www.minecraft.net/en-us/download/server/bedrock/ and is done using the command:

                LD_LIBRARY_PATH=. ./bedrock_server

                ran just like that from inside the Minecraft dedicated server folder. Let us know what you find!

  4. Avatar for Aron Gooch

    Firstly id like to say this is a fantastic write up.

    Unfortunately im having an issue I cannot seem to fix and apologise in advance if it has already been covered.

    The server is all setup and running great on my Ubuntu laptop. On a Windows machine on the same network I can see the server but when I try to connect it hangs on “locating server”. The server on the laptop shows the user as connecting but then MineCraft times out and the user is disconnected after a small amount of time. Any ideas what might be going on? Thanks

    1. Avatar for jamesachambers

      Hey Aron,

      There’s a couple things to check. One thing to watch out for is Bedrock primarily uses UDP but does use TCP for some things (I think it’s primarily UDP but I may have reversed them). This is usually why you ping the server or see how many players are on but then can’t actually connect. One type of traffic is making it through and the other isn’t. Often on firewalls people would select “TCP” and not the “UDP” side and see issues like this and the solution is to change it to “Both” on the port forward entry or add a second entry on firewalls that don’t have a both setting for both the TCP and UDP types.

      In your case I think something else is going on. Since you’re on the same network internally it shouldn’t have anything to do with the port forwarding. I think it’s probably a still a firewall setting though even though you are on the local network. It’s likely a software firewall setting on the computer itself because of an experience we had in the comments here a while back.

      The last person this happened to came back and left me a comment that the problem was actually the Windows firewall settings. You have to allow traffic on “Public” and “Private” networks (every single type) for the Minecraft client because of the way UDP traffic works. UDP traffic is stateless and is always “public” in that sense so Windows Firewall was blocking it for this person. It was causing the identical behavior of being able to see the server in the list but not actually able to establish a full session. I would check for this first.

      Hopefully that helps!

  5. Avatar for Steven

    Log File:
    ERROR: ld.so: object ‘/usr/lib/arm-linux-gnueabihf/libarmmem-${PLATFORM}.so’ from /etc/ld.so.preload cannot be preloaded (cannot open shared object file): ignored.

    NO LOG FILE! – setting up server logging…
    [2021-03-15 11:31:51 INFO] Starting Server
    [2021-03-15 11:31:51 INFO] Version
    [2021-03-15 11:31:51 INFO] Session ID [was here and valid]
    [2021-03-15 11:31:51 INFO] Level Name: Bedrock level

    chown: missing operand
    Try ‘chown –help’ for more information.
    Checking for the latest version of Minecraft Bedrock server …
    –2021-03-15 11:34:58– https://minecraft.net/en-us/download/server/bedrock/
    Resolving minecraft.net (minecraft.net)…,,, …
    Connecting to minecraft.net (minecraft.net)||:443… connected.
    HTTP request sent, awaiting response… 302 Moved Temporarily
    Location: https://www.minecraft.net/en-us/download/server/bedrock/ [following]
    –2021-03-15 11:34:58– https://www.minecraft.net/en-us/download/server/bedrock/
    Resolving http://www.minecraft.net (www.minecraft.net)…,
    Connecting to http://www.minecraft.net (www.minecraft.net)||:443… connected.
    HTTP request sent, awaiting response… 200 OK
    Length: unspecified [text/html]
    Saving to: ‘downloads/version.html’

    downloads/version.html [ ] 301.96K 922KB/s in 0.3s

    2021-03-15 11:35:00 (922 KB/s) – ‘downloads/version.html’ saved [309204]

    Minecraft Bedrock server is up to date…
    Starting Minecraft server. To view window type screen -r BedrockServer
    To minimize the window and let the server run in the background, press Ctrl+A then Ctrl+D-

    Debian on a Raspberry Pi w/ 4GB RAM, any reason this happens?

    1. Avatar for jamesachambers

      Hey Steven,

      The server is built for x86_64 so running it on the Raspberry Pi is done via emulation. It’s very slow and laggy unfortunately since a ARM version of the server has never been released.

      I have a special guide for the Pi on this here with some more information: Official Minecraft Bedrock Dedicated Server on Raspberry Pi*

      Some people have thought it was fast enough and were able to get it working for their purposes on the Pi but for me and most others it’s way too laggy but definitely check out the article and see if you want to move forward. Hopefully that helps!

  6. Avatar for Norm Parker

    Hi James!
    Thank you SO MUCH for your expertise and help. I have been using your scripts for a long time, they seem to always work. However, this new client update from Microsoft to (minecraft for windows, bedrock) and the server update to seems to have introduced problems. The client will not connect to the server.
    Have you tried this?

  7. Avatar for Rudasyy

    Thi happens when I setup the minecraft help me please.
    ./SetupMinecraft.sh: line 159: sudo: command not found
    ./SetupMinecraft.sh: line 164: screen: command not found$ ./SetupMinecraft.sh: line 159: sudo: command not found

    1. Avatar for jamesachambers

      Hey Rudassy,

      It looks like you’re missing sudo and screen on the system.

      You should be able to install this with your package manager with something like apt install screen or the like depending on the package manager. The script tries to get these for you when it sets it up using apt (and even tries to get them for a few other OS’s I’ve used with it before) but I’m guessing that you are using something different than Raspberry Pi OS or Ubuntu. Which OS are you using?

      Just getting the “sudo” application installed will probably do it. That may be why it’s not installing any dependencies for you!

  8. Avatar for Mat

    Thankyou for this. I have almost no experience with any if this stuff and following these instructions, I was able to get up and running easily.
    How do I change the dificulty setting for the world?….my children would prefer to play in normal.
    Is it possible to change the ‘seed’ for the world?
    Thanks again.

    1. Avatar for jamesachambers

      Hey Mat,

      Thanks for the kind words, I’m glad it was helpful!

      Both the difficulty and the seed can be set in the server.properties file. You can edit this file by going into the your server’s folder. It’s located at ~/minecraftbe/yourservername. You can just open the file with a text editor if you are using the desktop version of Raspbian (you can do this in a file window) or you can do it in the terminal by typing:

      cd ~/minecraftbe/yourservername
      nano server.properties

      You’ll see the difficulty in there and you can just change it to difficulty=2 for “Normal” mode. There’s a list of all the options and what they do here at this document (scroll down to the “Bedrock” section as the top one will be for the “Java” version). This will tell you what all of the other options to do and what values you can put in to adjust them. It’s pretty easy!

      Changing the seed will also be in here. The seed will either be nothing (blank) or a randomly generated one. You can replace the part after ‘seed=’ with the seed you’d like to use. Once you replace the seed you may need to remove the “world” folder as the initial chunks will have generated with the old seed (at least around the spawn or where anyone has logged in and gone to) but this is optional (just make sure you close the server first if you try to remove the world folder). All new chunks will generate with the seed in server.properties after a restart!

      Once you’ve finished making changes press Ctrl+X to save and then answer “y” to the prompt to save your changes (if you used nano, if you used the GUI just choose save from the menus). Hopefully that helps and have fun!

  9. Avatar for Pete

    Hi James, Thanks for the script. I had this running on Ubuntu 18.04 for ages and it worked perfectly. Upgraded to Ubuntu 20.04 and I can no longer start the service. Re-running the original script doesn’t work either. Thoughts? Here is the error:

    ● BedrockServer.service – BedrockServer Minecraft Bedrock Server
    Loaded: loaded (/etc/systemd/system/BedrockServer.service; enabled; vendor preset: enabled)
    Active: failed (Result: exit-code) since Sat 2021-03-06 08:52:46 NZDT; 10s ago
    Process: 309975 ExecStartPre=/bin/chown -R admin /home/admin/minecraftbe/BedrockServer (code=exited, status=0/SUCCESS)
    Process: 309988 ExecStart=/bin/bash /home/admin/minecraftbe/BedrockServer/start.sh (code=exited, status=0/SUCCESS)
    Process: 310066 ExecStop=/bin/bash /home/admin/minecraftbe/BedrockServer/stop.sh (code=exited, status=1/FAILURE)

    Mar 06 08:52:41 srv01 bash[310009]: 250K ………. ………. ………. ………. ………. 72.1M
    Mar 06 08:52:41 srv01 bash[310009]: 300K .. 5556G=0.04s
    Mar 06 08:52:41 srv01 bash[310009]: 2021-03-06 08:52:41 (8.33 MB/s) – ‘downloads/version.html’ saved [310183]
    Mar 06 08:52:41 srv01 bash[309988]: Minecraft Bedrock server is up to date…
    Mar 06 08:52:41 srv01 bash[309988]: Starting Minecraft server. To view window type screen -r BedrockServer
    Mar 06 08:52:41 srv01 bash[309988]: To minimize the window and let the server run in the background, press Ctrl+A then Ctrl+D
    Mar 06 08:52:41 srv01 systemd[1]: Started BedrockServer Minecraft Bedrock Server.
    Mar 06 08:52:46 srv01 bash[310066]: Server is not currently running!
    Mar 06 08:52:46 srv01 systemd[1]: BedrockServer.service: Control process exited, code=exited, status=1/FAILURE
    Mar 06 08:52:46 srv01 systemd[1]: BedrockServer.service: Failed with result ‘exit-code’.

    1. Avatar for jamesachambers

      Hey Pete,

      I would try removing the service and rerunning the script completely. This can be done with:

      sudo rm -rf /etc/systemd/system/BedrockServer.service
      sudo systemctl daemon-reload

      You can also try running the service yourself and see what happens with:

      sudo systemctl start BedrockServer

      This may yield an error message that may be helpful. It may also be possible that after your upgrade you just need to reload the daemons with the command:

      sudo systemctl daemon-reload

      Can you give those three things a try? This should help us narrow down what is going wrong here!

      1. Avatar for Yves

        Hi, just wanted to jump in and mention that I had the exact same error a week or so after my initial setup and deleting the .service file and rerunning the script fixed the issue.

        thank you!

  10. Avatar for Anders Ruberg

    Awesome script, was able to setup a bedrock server in a couple of minutes on ubuntu 20.04 server!
    One question, is it possible to get timestamp in the server logging? I would like to be able to get some stats for how long time a player has been connected etc.
    Currently it just says
    [INFO] Player connected:

  11. Avatar for Knut

    Hi James,

    thank you for the brilliant guide! It worked perfectly on a HP Microserver!

    After that, I wanted to set up on a standalone server, so that the kids can play around on therer own. An older Dell 4600 with Pentium 4. I upgraded the Memory to 2GB, put in a 240GB SSD. Just when I installed Ubuntu, I realised that it is a 32Bit system. After some trying I found a 18.04. LTS for 32 Bit and the installation went fine. Then I was stuck. I understood, that I somehow need to get a 64-bit emulator with QEMU running, but it seems beyond my capacity. I found a lot of comments on your site, but something in the beginning seems to be missing. Could you give me some hints what to do after I installed ubuntu?

    BR, Knut

    1. Avatar for jamesachambers

      Hey Knut,

      That is awesome, I have wanted one of the HP Microservers for a long time! I have a couple old retired servers I use at home (Gen8 ML350p) and I’m fairly certain one Microserver could handle all the duties those perform and then some!

      So for the 32 bit we did try once before and the issue we ran into was that the libc library available on 32 bit Ubuntu was too old to support running a newer version of QEMU. You can check this thread out here where we give it our best to try to get it to run on 32 bit on both Ubuntu and Debian. I think Matt eventually gave up (which I don’t blame him, he had installed 2 32 bit OS’s and was still running into too old of libraries at every turn).

      That being said, you can definitely give putting QEMU on there a try. It has been a couple of months and maybe they backported the right libc back to 18.04 potentially. It may be worth trying with the steps I gave to Matt in there to see if you can get QEMU going but I wanted to give you the heads up that we have ran into trouble trying this before. This method can even be used to run the server on the Raspberry Pi. Building a static version of QEMU yourself from source should also work but it’s quite a bit of work and takes a long time to build.

      I think the biggest issue we ran into is that most 32 bit distributions/updates seem to have been discontinued. Here’s Ubuntu’s official discontinuation of 32 bit which wasn’t supposed to impact 18.04 in this announcement but the libraries in there were too old to run a new enough version of QEMU. There has to be some other distros out there that still update 32 bit so that is another thing to check as well!

        1. Avatar for knut

          Hi James,

          sorry, took some time to work on my server. I made some progress:
          1) tried to install Debian Bullseye on the machine. Did not work, won’t recognise my harddisk.
          2) installed Debian Buster. Everything went fine.
          3) “sudo” not installed. Used “su root” to install sudo package.
          4) user was not in the sudo file. Had to add it.
          5) path to “route” not set, added it to .bashrc
          6) tried your script again, did not work, QEMU version is 3.2 only.
          7) upgraded to Bullseye. Everything went fine, no issue with harddisk or controller.
          8) run your script. All good.
          9) changed the start of bedrock server in the script to “LD_LIBRARY_PATH=. qemu-x86_64-static bedrock_server”
          10) server started! I see output in the screen.
          11) can see the server in client (xbox) and can see the user connect in the server console.
          12) but takes a long time and game does not start. Never tried more than 15 min though.
          13) CPU load is permanent 100% (using htop). I have to find out, if it does not work or just takes a looong time. I am not sure, if performance of P4 with 2.8 Ghz is enough.

          To be continued…

          1. Avatar for jamesachambers

            Hey knut,

            That sounds extremely promising! I was hoping emulation would be faster than the Pi but it’s sounding pretty slow.

            I do have some tips from testing on the Pi. When I tested I had to try logging in I would say about 3 times before I would actually get in the game for the first time. It seems like the first time you join it generates the entire starting region which is *very* slow through emulation. Once that is done you will be able to log in and actually enter the world.

            On the Pi it’s still too laggy to play on my opinion but others have said it was fast enough for their purposes. X86 should still be an easier bridge to cross for QEMU than ARM -> X86_64 but we will have to see how it does after it finises generating!

            1. Avatar for knut

              Thanks for another good advice. In order to shorten the time for generating the world, I just copied it from the other (64bit) machine. After that it took around 8 min to enter. So, it works. Technically. Opening a chest takes 4 seconds. Seems far too much to try to optimize something.
              Thank you for a lot for great support!

              1. Avatar for jamesachambers

                Hey knut,

                No problem at all! I’m thinking of trying another method I ran across the other day using box86. This seems to be faster than QEMU and I am hoping it will make a difference!

                The next Pi may be able to do it as well. When I originally did this a year or two back it was too slow to even log in (no matter how many times you tried) so it has been steadily improving. I think this is due to updates in QEMU mostly but each generation the hardware gets better as well!

                1. Avatar for knut

                  I gave up. Bought a new server. https://amzn.to/3bJR1PJ

                  Took me 15 min to install Ubuntu 20.04 and 5 min to install the minecraft server with your script! Quickly copied the old world. Amazing, everything works perfectly!

                  James, thanks a lot!

                  1. Avatar for jamesachambers

                    Hey knut,

                    That looks like a great mini PC! I actually recommend something similar in some of my original articles for it. It’s a great solution!

                    I’m glad everything is working well, take care!

  12. Avatar for Ema

    Hi James!

    Thanks a lot for this scripts! it’s really easy to make a server!

    I had one problem. I’m using it in a VM and in that VM I have 2 eth ports. For some reason when you use 2 eth ports I can’t connect to the server outside my network (over internet) but when I have only one eth port I can access without ptoblem. What can it be? I tried to see if I need to configure the port but I don’t find nothing to do that on your script.

    Hope you can help me!

    Best regards

    1. Avatar for jamesachambers

      Hey Ema,

      If I were to guess I would say that it’s potentially listening on the wrong IP address. When you have 2 eth ports it should have two different IP addresses for each one of those ethernet connections. If you type the command “ifconfig” (may need to be installed through apt-get, it will tell you which package you need if it’s not present, usually the net-tools package) it should give you a list of all your connections and the IP addresses assigned to them.

      You should be able to put the IP address you want to bind and “listen” on in server.properties which is located in the ~/minecraftbe/yourservername folder.

      The property you would set in the server.properties file for your server would be:


      Normally it’s recommended to leave this blank (which will usually try to listen on or all IPs) but the option is provided for situations where there might be multiple network connections and leaving it blank isn’t listening on the desired/correct IP(s). If you set the server-ip property and restart the Minecraft server it should be available on that address!

      1. Avatar for ema

        Hi James!

        Thanks for your reply! I tried it without success. But I think that I have another issue. I have the port Opened but when I sniff the traffic I only see the protocol Raknet that say’s unconnected Ping. The port is open becouse on the server side I can see the request, but I don’t know why the server doesn’t respond. Also I’m using other Port, not the default port.

        Best regards.

        1. Avatar for jamesachambers

          Hey ema,

          I’m fairly certain that is a known bug with the dedicated server right now when using alternate ports. It’s a bug in the server software itself and unfortunately has been outstanding for months (or more) now!

          If you ping/query the original ports they may still respond (or not sometimes, people have observed strange behavior such as the order they start up multiple servers impacting this and other odd behavior) even if you set alternate ports. If you set everything back to the default ports does it work correctly?

  13. Avatar for Moses

    So i have the server installed on an old desktop and it is working, i can connect to it using the same network. We have 2 routers the one is connected to the public ip, and the other is a local network, the one with the public ip (let’s just call it router 1) forwards port requests to router 2 (the local network one). But my friends can’t seem to connect, any tips or advice? i’m sure you can fix it based on all the other people you’ve helped

    1. Avatar for jamesachambers

      Hey Moses,

      Going through two different routers gets very tricky. The configuration you are describing looks like a double NAT issue to me:


      Your configuration may not match the picture perfectly depending on what role the internet device has (this picture shows a standalone modem but a lot of them these days are wireless modems as well that also have their own private network). The double NAT issue comes from when you’re going through two routers like this that both have private networks. You can do this and it won’t break the internet but it will break port forwarding and have some other side effects such as Xbox Live and Sony PSN rating your console’s connection as poor and unsuitable to be a game host, etc.

      The bottom of the article I linked has some alternate configurations you can try to resolve the double NAT issue such as putting the internet connected device in “bridge” mode. If you are in control of both of these networks (at least enough to configure them) then it may be worth a shot to try putting it in bridge mode!

      1. Avatar for Moses

        Thank you for the quick reply, i changed from where the server was connected, i connected the server to router 1 and now it works well.

        Thank you for this post because it would’ve taken me ages and a loss of sanity to get this done.

        Thank You!

          1. Avatar for Moses

            sadly i have yet another problem, it’s been a few days since my MC server got running, i log in this time but it says “You need to authenticate to Microsoft services” and then I can’t do anything, i don’t want to turn of online mode in server.properties because that kind of beats the whole point of the server

            1. Avatar for jamesachambers

              Hey Moses,

              It sounds like you need to sign out and back into Xbox Live on the computer you are connecting with giving you that error. You can also restart the server if you haven’t done it already but most likely the issue is actually with the client. Usually signing out and back in to Xbox Live will do the trick!

              EDIT: Oops, I just saw your other message that the authentication servers are having issues. There’s nothing you can do on your side about that and I’m sure it will be fixed soon!

                1. Avatar for Moses

                  So i don’t know if this is in your realm of knowledge i assume you can help me with it though, i am trying to make a java server, and i want to make it run on startup because if i want to play i have to turn it on using an SSH i want it to run in the background without having to worry about that. From what i’ve seen with your code you are able to make it run automatically flawlessly so i was wondering if you’re able to help me with it

  14. Avatar for Dmitri

    Hello! Thank you for the fantastic job done! The installer goes like a breeze!
    Do you have a modified version of the same script that is capable of installing any server version available for download with version number passed as, say, a script parameter?

  15. Avatar for Martiese

    Hello! Thank you for this.
    I also followed along to the discussion in the comments and was able to add a second server instance with different ports and delay, however Its too much for my little old machine to have multiple running.

    How to uninstall / remove multiple instances?

    1. Avatar for jamesachambers

      Hey Martiese,

      Great question! There will be a service created for the server that will be located at /etc/systemd/system/yourserverlabel.service. The “yourserverlabel” is the label you gave to your server during the installation. If you aren’t sure what it is you can cd /etc/systemd/system and then do:


      to see all the services installed on your system (be careful though, there’s lots of system services in here, but it should be obvious which one is the one you chose previously).

      Now just type:

      sudo rm -f /etc/systemd/system/yourserverlabel.service
      sudo systemctl daemon-reload

      And that will remove the startup service!

      1. Avatar for Martiese

        This worked perfectly. I really appreciate the response.

        I also wanted to note that your blog is very informative and the fact that you are so responsive and active in the comments as well, has turned this into more than just a blog post, but a learning adventure. Thank you.

  16. Avatar for Manney

    Hi James,
    thanks for this …. used parts of this to get a server up and running in azure both my sons + 6 of their mates all connected in using their xboxes…. happy days 😉

Leave a Comment

Your email address will not be published. Required fields are marked *

Type here..