Raspberry Pi Minecraft PE Server
In this tutorial we will be showing you how to setup your very own Raspberry Pi Minecraft PE server. This is a cheap way of providing you with an always on, Pocket Edition capable server.

This stops you from having to leave your phone or computer online if you want others to be able to always access your world. The Pi is also pretty good on power usage so you can save on your power bill too.

Ultimate Books of Pi

For this tutorial we will be making use of the Nukkit software. We decided to utilize Nukkit since we found that it was one of the most stable Minecraft Pocket Edition servers currently available.

Please keep in mind the Pi is quite limited in resources so you may have some issues when it comes to performance. Tweaking the server properties is a great way to get more performance and maybe some room for more people. I wouldn’t recommend having more than 5 people joining the server, however you may want to experiment to see how much it will be able to handle.

If you’re after a server for the Java version of Minecraft then you should check out our previous tutorial that shows you how to setup a spigot Minecraft server.

If you would like to know more about the server software then you can find out more about it at the Nukkit website.

Equipment List

The following pieces of equipment are what I recommend when it comes to completing this Raspberry Pi minecraft pocket edition server.


Raspberry Pi 3

Micro SD Card

Ethernet Cord or WiFi dongle (Use a ethernet cord for the best performance)

Power Supply


Raspberry Pi Case

Note: Don’t forget that if you’re using a Pi 3 then this has WiFi inbuilt and you won’t need a dongle.

Setting up your Raspberry Pi Minecraft PE Server

In this tutorial, we will work completely within the terminal. In fact, it is best to change the boot mode of the Raspberry Pi so it boots directly into the terminal for the Minecraft Pocket Edition server. You can also install Raspbian lite so you don’t install any of the additional packages that comes with the full version of Raspbian, just make sure you install java as we will need that.

Minecraft PE servers are hugely demanding on the Raspberry Pi’s hardware, so every extra bit of resources made available to it, the more it can handle. It’s important to keep this in mind before installing any additional software packages that may drag the performance down.

1. First let’s make sure everything on the Raspberry Pi is up to date by running the following two commands.

sudo apt-get update
sudo apt-get upgrade

2. Now we will need to make a couple of changes in the raspberry pi config tool. Let’s open the tool by entering the following command:

sudo raspi-config

3. First, let’s go to Advanced Options->Memory Split and update this to 16. (This will allow for more memory to be free for the server)

4. Secondly, now is a good time to change the “boot up” option so that it boots straight into the terminal. Go to Boot Options->Desktop/CLI, Press Enter with Console selected to enable booting to console.

Note: This does not need to be done if you’re running on Raspbian lite.

5. To truly make the most of the Minecraft Pocket Edition server, you will need to overclock your Raspberry Pi.

The following steps only work with the Raspberry Pi 1 and 2 as the raspi-config tool does not currently support the Raspberry Pi 3 for overclocking.

While you’re still in the raspi-config tool, go to Overclock, here pick the “High” overclocking option. This will give the Raspberry Pi a good overclock, though make sure you have a decent, stable power supply, most USB chargers will not cut it.

6. If you haven’t activated SSH before, make sure you go to Advanced Options->SSH and select “Enable”. You will need this for easy access to your Raspberry Pi.

7. Now go to “Finish” and reboot your Raspberry Pi using the following command.

sudo reboot

8. Before we get to ahead of ourselves, now is a great chance to grab the IP address of the Raspberry Pi. You will need to write down the value from the next command, we will need to use this later.

In the terminal, enter the following command:

sudo hostname -I

9. With that now setup, we will now proceed with downloading and setting up the Nukkit server software. Before we get too far ahead of ourselves, let’s first make a directory to keep this in, run the following commands to make the directory in the pi user’s root directory.

mkdir ~/nukkit
cd ~/nukkit

10. Finally, let’s download Nukkit, normally we will have to compile the software which can take a while due to the Raspberry Pi’s low processing power, thankfully some nice users have provided their CI (Continuous Integration) servers to the public.

Run the following command to download the latest build of Nukkit to your Raspberry Pi.

wget -O nukkit.jar https://pimylifeup.com/out/nukkit

11. With Nukkit now downloaded to our Raspberry Pi we can now run it, this will generate all the files we need to be able to configure the server further.

Running Nukkit is incredibly easy, we can run it with the following simple command.

sudo java -jar nukkit.jar

Upon running the server for the first time you will be asked to choose a language, for this tutorial we will be using English. Therefore we typed eng into the console and pressed enter.

select language

The server should immediately begin to boot up, the server should display the following text when it is ready to be connected to.

[INFO] Preparing level "world"
[INFO] Starting GS4 status listener
[INFO] Setting query port to 19132
[INFO] Query is running on
[INFO] Default game type: Survival Mode
[INFO] Done (3.109s)! For help, type "help" or "?"

While you can now begin to play on your server you might want to first configure it so it is setup more to your liking. To do this, first kill the process by pressing Ctrl + C.

12. There are two configuration files that come with Nukkit, one controls Nukkit’s own options such as being able to change the number of chunks it loads in, the other controls the actual Minecraft options such as what game mode you want the server to be using.

You can read up on the server.properties file and see what changes you can make to it by going to the Minecraft server properties page.

Run the following command to edit Nukkit’s configuration file.

sudo nano nukkit.yml

Alternatively, run the following command to edit the Minecraft server configuration.

sudo nano server.properties

Once you have finished making your changes to the configuration files, make sure you save them by pressing Ctrl + X then pressing Y and then Enter.

Afterwards you can immediately proceed to start up Nukkit again by typing in the following command:

sudo java -jar nukkit.jar

Connecting to your Raspberry Pi Minecraft PE Server

If you’re on a local network, then it will be easy to connect to the Raspberry Pi Minecraft PE server. To test out our recently setup server we will need to do the following.

Now load up Minecraft on a Mobile Phone or a Windows 10 PC (Minecraft Windows 10 Edition) that is located on the same local network as the Raspberry Pi.

minecraft pocket edition main menu

Go to the friends tab and then your server should pop up at the bottom under LAN Games. If it doesn’t simply go to direct connect and enter the IP we got earlier on the Pi using the command hostname -I. We have highlighted the direct connect button in our screenshot below.

Raspberry Pi Minecraft PE Server Connect Buttons

If you want to allow access to the Minecraft Pocket Edition server via the internet, then you will need to setup port forwarding. You will need to port forward the port 19132 (Unless you change it in the server properties) to the local IP address of your Raspberry Pi. Keep in mind opening ports always increases the security risk from outside sources.

For more information check out our port forwarding guide for the Raspberry Pi. You can also find this in our Raspberry Pi project ebook along with a ton of other projects & guides.

Hopefully by now you should have a fully operational Raspberry Pi Minecraft PE Server. If you come across any issues or have some feedback related to this tutorial, then please don’t hesitate to leave a comment below.

Ultimate Books of Pi Bottom
Pi My Life Up's Crash Course
to the Raspberry Pi

Pi My Life Up's Crash Course

to the Raspberry Pi

Subscribe to our email list to get the

Crash Course delivered straight to your inbox

Please check your inbox for a confirmation email!