Raspberry Pi Minecraft Server

by Gus

Updated Aug 14, 2024

If you buy through our links, we may earn an affiliate commission. Learn More.

A Raspberry Pi Minecraft server is a cost-effective way to have your very own private server with your friends or just for stuffing around on.

I have had mine running for quite some time now and haven’t come across too many problems. It is very important to know that this server will not be able to hold many people.

From my experience, anything over five people and the server will start to get a bit wonky. I found the optimal amount of people is only two to three, but this can be improved upon by tweaking the server.

We are also going to be using the spigot version of Minecraft as the default install didn’t work for me. I found that it will crash a lot, be laggy, and is very unstable. The official Java version may improve over time.

If you are looking for the Bedrock server, be sure to check out our Minecraft Bedrock server tutorial. It will take you through all the steps to setting it up correctly.

In this project, we will utilize Java, which should already be installed on Raspberry Pi OS. We will make a few changes to optimize the server for the Raspberry Pi 2, 3, 4, or 5. We will also set it up so you can access it on the web, and have it reboot if the Pi goes offline for any reason.

Equipment

Please find the equipment that I used for making this Raspberry Pi Minecraft server below.

Optional

HDMI Cable ( Amazon )
Raspberry Pi Case ( Amazon )

Video Tutorial

If you want to see how to set up the server, then check out my video below. Otherwise, I have a detailed text explanation immediately below the video.

If you like the video, please make sure you subscribe or follow us on social media, so you are kept up to date.

Setting up the Raspberry Pi Minecraft Server

Firstly, we must install an operating system onto the Raspberry Pi. If you haven’t already done this, check out our awesome guide on installing Raspberry Pi OS. It will take you through all the steps that you will need to do.

In this tutorial, we will work entirely in the terminal. It is probably best we boot straight into the terminal so we can save on resources by not loading the GUI.

1. First, update operating system packages to the latest version by entering the following commands.

sudo apt update
sudo apt upgrade

2. Now, we will need to make a couple of changes in the config tool. Let’s bring the tool up by entering the following line.

sudo raspi-config

If you need more information regarding the raspi-config tool, please check out our guide.

3. Also, it is unlikely you want to boot into the desktop, so ensure the boot option is set to the CLI (Command Line Interface). This change will help give the server as much processing power as possible.

To change the boot option, select 1 System Options, and select Boot / Auto Login.

Select Console or Console Autologin.

4. Finally, enable SSH so we can access the Pi remotely if required, unless you already have it enabled.

To enable SSH, go to Interface Options. Next, Select I1 SSH. Lastly, answer <YES> to enable the SSH server.

5. Now go to <Finish> on the main screen and answer <YES> to the reboot question.

6. We will now want the IP address of our Pi for when we try to connect to our server. To get the Raspberry Pi IP address, enter the hostname command.

sudo hostname -I

To ensure the IP doesn’t change, you should set up setup a static IP address on the Raspberry Pi and your router.

7. Next, we need to make sure that Git and jq is installed. Otherwise, we will not be able to build the server.

Enter the following command to install the Git software as well as jq. jq allows us to easily interpret JSON data within the terminal.

sudo apt install git jq

8. By default, Java (17) should already be available on Raspberry Pi OS (Bookworm). However, if you wish to use the latest version of the Minecraft server, you will need to use a newer version than what is available.

To install a version of Java compatible with Minecraft 1.20.6 + (Java 21 or 22), please follow our installing Java guide.

9. Now, we will need the Minecraft server file, which we will create using a builder tool that Spigot supplies.

To get the tools, enter the following commands.

mkdir ~/minecraft
cd ~/minecraft
wget https://hub.spigotmc.org/jenkins/job/BuildTools/lastSuccessfulBuild/artifact/target/BuildTools.jar

10. Now we will want to run the build tools file, so it creates our Spigot server. It will take about 15 minutes to finish.

Change --rev latest at the end of the command to get a different version. Don’t forget to change latest in the command to the version number you wish to download. For example, --rev 1.20.6 will download version 1.20.6.

java -Xmx1024M -jar BuildTools.jar --final-name server.jar --rev latest

Important: If you have a Raspberry Pi B+, B, or any variation before the Raspberry Pi 2, the build tools will likely fail. You will need to generate the spigot.jar on a more powerful computer instead.

11. To ensure the Spigot server successfully downloaded and saved, simply type ls. You should see spigot-1.20.6.jar. The filename may be different depending on the version you downloaded.

ls

Make sure you remain in the ~/minecraft folder as we want all the server files to be created in here. If you start the server in a different folder, it will create the files there.

12. Now we are ready to launch the server. To do this, enter the following command. You may need to change the version number depending on what version you’re using e.g. spigot-1.20.6.jar.

Raspberry Pi 1

java -Xms256M -Xmx496M -jar ~/minecraft/server.jar nogui

Raspberry Pi 2, 3, 4, or 5

java -Xms512M -Xmx1008M -jar ~/minecraft/server.jar nogui

With the 2GB and 4GB variants of the Raspberry Pi 4 or 5, you can increase the Xmx value even higher.

The server will stop straight away as we will need to agree to the Eula. You can do this by opening the Eula by typing the following command.

nano eula.txt

13. In here, change “false” to “TRUE“. Once done, save and exit by pressing CTRL + X, then Y.

14. Now relaunch the server. It will take a while to create a map, so give it about three to five minutes. If you ever reboot again, it will only take thirty seconds to load if the map has already been created.

15. The server should be running and accessible over the local network.

16. You might want to mod your user now so that you can use all the server commands when you log in. If we have it auto-boot on startup, accessing the server backend is slightly more difficult.

To mod your user, simply run the following command when the server has launched (Replacing username with your username).

op username

17. The Minecraft server on the Raspberry Pi will now be up and running fine, but you may want to do some optimizations to the server to make it run even better.

Connecting to the Minecraft Server

If you are on a local network, it should be pretty easy to connect to the Minecraft server running on the Raspberry Pi. To test it out, follow the steps below.

1. Load the Minecraft Java client on a computer within the same local network as the Pi. Ensure the version of the client matches the version of the server.

2. Go to multiplayer, and your server might appear in the local list. If it doesn’t, simply go to direct connect and enter the IP address we got earlier on the Pi using the hostname command.

hostname -I

3. If you want to allow access to the Minecraft server via the internet, you will need to set up port forwarding.

Assuming you want to learn how to do this, head over to my guide on setting up Raspberry Pi port forwarding. You will need to port forward the port 25565 (unless you change it in the server properties) to the IP of your Pi.

Configuring the Server

Here are a few tips for configuring the server and getting it up and running.

Optimizing the Minecraft Server

To get the most out of our Minecraft server on the Raspberry Pi, you can install a plugin to help optimize the performance.

There are many plugins that can help with performance or extend the server’s functionality. Simply use the wget command to download them to the Pi. Below is an example.

cd ~/minecraft/plugins
wget -O example.jar <example_plugin_url>

Editing the Minecraft Properties

You will probably want to know how to edit the server properties. This ability to edit is very important for optimizing the server and customizing it to how you want the server to be.

If you want more information for each of the server settings, you can find a good page on all the server properties here.

To enter the server properties, enter the following line.

sudo nano ~/minecraft/server.properties

Now, we will want to change a few settings to help optimize the performance of the server.

You can change these and other settings to whatever you like however you want, but keep in mind the Pi can’t handle too much processing.

view-distance=04
max-player=5

Boot on Startup

To have the server start on boot, we will need to do a few extra steps.

1. We will need to create a service for the Minecraft server so let’s start writing the service file by entering the command below.

sudo nano /lib/systemd/system/minecraftserver.service

2. In this file you will need to enter the following text.

This file defines the service, so the service manager knows how and what to run. Don’t forget to update the spigot version number whenever you upgrade.

Update “<USER>” with the username you plan on using to run the server. You can see the username of your user by entering the whoami command into the terminal.

[Unit]
Description=Minecraft Spigot Server

[Service]
User=<USER>
Group=<USER>
Restart=on-abort
WorkingDirectory=/home/<USER>/minecraft/
ExecStart=/usr/bin/java -Xms512M -Xmx1008M -jar /home/<USER>/minecraft/server.jar nogui

[Install]
WantedBy=multi-user.target

Once done, save the file by pressing CTRL + X then Y followed by ENTER.

3. Now, we will need to enable the service. You can enable the service by running the command below.

sudo systemctl enable minecraftserver.service

4. You should now be able to start the Minecraft server by simply using the following command.

sudo systemctl start minecraftserver.service

5. Using a similar command, you can check on the status of the service. Checking the status is great for debugging.

sudo systemctl status minecraftserver.service

5. You can stop the server by using the following command.

sudo systemctl stop minecraftserver.service

Your server should now start on boot. You can test it by restarting the Raspberry Pi. It will take a few minutes to startup.

sudo reboot

If you want to get access to the server on the command line, then you will need to shut down the server and load it using the normal command.

Updating your Minecraft Server on the Raspberry Pi

In this section, we will be showing you how to update to the latest version of the Minecraft server on your Raspberry Pi.

1. Before we can begin to update the Minecraft server, we will need to change to the directory where the server is stored.

If you have followed our tutorial, this means you should be able to change to the correct place by running the command below.

cd ~/minecraft/

2. The first thing we will want to do now that we are in the right place is ensure we have the latest version of the Spigot build tools.

We can use the wget command to download the latest release by using the following in the terminal.

wget https://hub.spigotmc.org/jenkins/job/BuildTools/lastSuccessfulBuild/artifact/target/BuildTools.jar

3. With the build tools updated, we can now grab the version number for the latest version of the Minecraft server by using the following command.

If you have a particular version of the Minecraft server, you want to use on your Raspberry Pi replace the command with that here. Otherwise, we can use a bit of curl and jq magic to get the version number we are after.

MINECRAFT_VERSION=$(curl -sS https://launchermeta.mojang.com/mc/game/version_manifest.json | jq -r '{latest: .latest.release} | .[]')

4. Once you have got your version number saved to the environment variable we can proceed.

Before we can update the Minecraft server on our Raspberry Pi, we will need to stop the current one from running. You can stop the running server by running the command below.

sudo systemctl stop minecraftserver

5. Now use the Spigot build tools to download and update you Minecraft server to the latest version.

Please note that this process can take a couple of minutes to complete.

java -Xmx1024M -jar BuildTools.jar --final-name server.jar --rev $MINECRAFT_VERSION

6. Once the update process completes, you can start the server up by using the following command.

sudo systemctl start minecraftserver

Conclusion

I hope this tutorial has helped you in setting up a stable version of a Raspberry Pi Minecraft server. If you like this tutorial, then be sure to check out our many other Raspberry Pi Projects.

Also, feel free to drop us a comment below if you have better optimization settings, plugins, or ideas. If you’re having trouble, let us know below.

303 Comments

Steven on June 15, 2016 at 6:37 am

having trouble updating to 1.10, can i get some assistance

Reply
Peter Lowe on June 1, 2016 at 7:53 am

Everything seemed to be going fine until I got to ‘sudo nano eula.txt’ where nothing is found. I just get a blank new file. Thinking about this now it could be that I downloaded 1.9 spigot. I am one of those strange creatures (teachers) who want to use Minecraft for Pi to teach Python programming. Should I go back through the config and stipulate ‘Minecraft for Pi’ and how do I do that?

Reply
1. Marc on June 2, 2016 at 12:57 am
  
  If you’re getting a blank screen that means it’s creating a new file. Just viewing the EULA you don’t need to use SUDO and a simple CAT, MORE or LESS will suffice.
  
  Reply
2. Marc on June 2, 2016 at 1:04 am
  
  Come to think of it Peter, it sounds like you’re in the wrong directory. Use PWD (print working directory) to make sure you’re where you think you are and LS to see if the file exists.
  
  It’s been a while since I installed Spigot but I am using 1.9 on that device.
  
  Reply
Thomas on May 28, 2016 at 8:22 pm

I have completed all the steps and I think it’s a great and straight forward tutorial. But, I don’t know how to change the wold’s seed. I typed in the seed I wanted in the server.propeties folder next to ‘level-seed=’. But when I reloaded the seed the world didn’t change 🙁
Plzzz help,
Thomas

Reply
1. wizdude on May 28, 2016 at 11:12 pm
  
  the seed is only used when the world is first generated. it is not possible to change the seed once once the world exists.
  
  if you wish to re-seed your world with a new seed specified in the server.properties, you need to stop your server and delete the entire “world” folder (with a command such as: rm -r world)
  
  when you start your server again, a new world will be generated using the seed you have specified.
  
  it should be obvious, but be aware that by removing the world folder you are erasing the minecraft world you have been working in.
  
  happy seeding!
  
  Reply
2. Thomas on May 31, 2016 at 3:57 am
  
  Thanks! But there’s one more problem, when I use the command : ‘rm -r world’ and try to remove it, Terminal says : ‘rm: cannot remove ‘world/session.lock’ : Permission denied’. It’s really frustrating! :'( >:( Is there any way round this? If so, plzzz tell me.
  
  Reply
3. marc on May 31, 2016 at 10:33 pm
  
  The system won’t allow you to remove files that are in use. Sounds like your sever is still running. If you stop it (using “killall java” example, although that’s a bit brutal) you should be good to go. Failing that, restart your PI and remove the world with “sudo rm -fr world” (CAREFUL!) that should sort you.
  
  Reply
Drew on May 9, 2016 at 3:13 pm

I just got my MC Pi server up and running thanks to this tutorial! I did the setup using ssh (for the first time) on my Mac to contact the Pi. Is it possible to copy a previously saved game file from my Mac directly to the Pi, or will I need to put it on a thumbdrive? I would appreciate any guidance on how to copy the files over and how to get the saved game running on the server rather than the game initiated when I launched the server.

Reply
Nick on May 9, 2016 at 8:47 am

Everything was great. But then server stopped. We power-cycled. And then did the command again to restart server…but it seems like it started a new world again. Is there a way to get old world back?

How do we properly shut down and restart the same world?

Reply
youssef on May 5, 2016 at 2:13 am

Hello,i tried to connect to my raspberry pi 3 minecraft server but on the pc minecraft says”failed to verify username”.What can i do?

Reply
Rich on May 2, 2016 at 5:11 am

Hello, great tutorial! Can some one post up a link of the eula.txt file? Mine got corrupted and I need a clean copy. Thanks.

Reply
Jordan on April 29, 2016 at 1:41 pm

This tutorial was great. I have one question. How do you access the minecraft server from a PC that is on the same network. My raspberry pi 3 has an ip of 192.168.1.13, do I enter the ip address of the pi directly into the web browser on my pc??? Any help would be appreciated. Thanks in advance.

Reply
1. Berend Jan on May 8, 2016 at 8:04 pm
  
  Go to multi-player (in minecraft)
  
  And select “direct connect” put your server IP (and port when you don’t use the default one) there and connect. I need 192.168.1.50 for creative and 192.168.1.51:55566 for survival. The different port is only needed when you try to connect your server to the Web and make it aprochable from outside your (safe) home network.
  
  Reply
Kevin on April 28, 2016 at 2:31 am

Hello! I’ve got this problem. When i get to step 16 (Raspberry Pi 1 modell B) and run the command: sudo java -Xms256M -Xmx496M -jar /home/minecraft/spigot-1.9.jar nogui I get the error: “Error: Invalid or corrupt jarfile /home/minecraft/spigot-1.9.2.jar” I’ve tried deleting everything and redo the steps and got the same error, i reinstalled rasbian and did the step and still got the same error.

Someone please help me!

Reply
Culpritt on April 23, 2016 at 11:33 pm

Gus,
Mate this was a great project for us {DAD and kids}.
Your tutorial above was great we had it up and running in a couple of hours.

Reply
Guy on April 23, 2016 at 11:30 pm

Hi, this is my first Pi setup and wanted to say this was a great tutorial and after researching many sites on performance settings and making many modification to the server settings, have a very stable. *Lag is almost non-existent. you have to try\force to get it to lag.
~ RPi 3 running headless
~ Java v1.8 with Spigot 1.9 Mine craft sever
~ Plugins – ClearLag, NoSpawnChunks.
~ my World + Nether and The End are enabled
~ RPi3 has been up and running 24\7 for weeks now and very stable with 5 players.

*** Have a few Q’s: (I’m a noob at this Linux based stuff as well with MC server).
1. Was going to upgrade\replace the RPi3 with a new Odroid C2 (using eMMC5.0 storage) and wanted to copy the whole Minecraft Server folder from the RPi3 (spigot files\plugins\world) to the new Odroid C2 running on Ubuntu 16.04 (v1.1). http://www.hardkernel.com/main/products/prdt_info.php
~ Can this be done or do I have to Rebuild the MCserver.?

2. If I had to rebuild the server would I use the same steps \ install files I used to make the MCserver on the RPi3.? if different what would I use.?

3. on a Rebuild, would just copying my World be supported as is.?

Thanks in advance.!

Reply
1. Berend Jan on May 8, 2016 at 7:58 pm
  
  In your server.config you have named your world (default world) just build a new minecraft server on your new hardware. Copy your world directorys (world, world.end and world.nether) to your new server and tadaahhh.
  
  You can also change the name of your world. I renamed my world on my new server to mc-creative in the server.config and renamed the directory to me-creative. Easy as that.
  
  Reply
Nathan on April 18, 2016 at 11:57 am

Server seems to be working on my Pi2, but receive this while loading: “Java HotSpot(TM) Client VM warning: You have loaded library /tmp/libnetty-transport-native-epoll2403844579300997802.so which might have disabled stack guard. The VM will try to fix the stack guard now. It's highly recommended that you fix the library with 'execstack -c ', or link it with '-z noexecstack'.”

Also, I cannot see the server on any edition of Minecraft. I have been running the P.E. version, and the windows 10 beta. I understand this isn’t for the tablet or phone version. Is there a separate server that includes the compatibility?

Reply
1. Guy on April 23, 2016 at 11:37 pm
  
  My RPi3 Spigot v1.9 MC server (non P.E.) is very stable and I get this as well “Java HotSpot(TM) Client VM warning:” but have disregarded it since I could not find any real support of it in online forums and it never seems to cause problems in-game.
  But I’m a noob at this, so what do I know anyway..lol
  
  Reply
Kiah May on April 11, 2016 at 12:17 pm

Please update the mediafire path as it is invalid or deleted

Reply
1. Gus on April 11, 2016 at 2:12 pm
  
  Editor
  
  They’re all valid….
  
  Reply
Ian on April 7, 2016 at 8:43 am

Apparently, the build tools keep failing for me, and when I download directly from the mirror, Spigot shows up as “spigot-1.9.2.jar”, is colored red, and whenever I try to do “sudo java -Xms512M -Xmx1008M -jar /home/minecraft/spigot-1.9.2.jar nogui” it says “invalid or corrupt jarfile”. Any idea on what I could do?

Reply
1. Gus on April 7, 2016 at 12:34 pm
  
  Editor
  
  Hi Ian, that’s strange the build tools keep failing.
  I have reuploaded the spigot-1.9.2.jar file so you can try downloading and running it again.
  If that still fails you can try updating your Pi using the sudo apt-get update & sudo apt-get upgrade commands.
  
  Reply
2. Ian on April 8, 2016 at 6:16 am
  
  The jar file still won’t work for me. Also, I noticed that when I try to run the BuildTools, I have the error “Exception in thread “main” org.eclipse.jgit.api.errors.TransportException” which was mentioned on the spigot site as being caused by AntiVirus, but I don’t know how to whitelist the spigot site on the Raspberry Pi.
  
  Reply
3. Ian on April 8, 2016 at 8:33 am
  
  Well, I got it to work, but is there any way to kill the server without the process id? I think I forgot to use nogui in an important place.
  
  Reply
4. Jeff on April 8, 2016 at 10:59 am
  
  I’m using a Raspberry PI 2, like Ian I also found that my upgrade attempts from 1.9 to 1.92 failed. Here is the error:
  
  Exception in thread "main" java.io.IOException: Cannot run program "java" (in directory "."): error=2, No such file or directory
  
  Reply
Josh on April 1, 2016 at 3:07 pm

I got this up and running without any troubles. Now, though, Mojang just rolled out 1.9.2 and my server won’t let us log in unless we’re on 1.9.1. How do I update the server to the latest?

Reply
1. Steve on April 3, 2016 at 4:51 pm
  
  Hi,
  
  Gus answered this for me, back up in the comments. However, as this is the second time I’ve had to do Iit in month I did a crib sheet for myself and others here. http://abergavenny-online.uk/2016/03/updating-spigot-minecraft-servers/
  
  Reply
djlawzon on March 31, 2016 at 6:50 am

Hey, great guide. Got a server up and running if anyone would like to test it.

1.9 server running a couple plugins, seems to run ok with a couple players.

Address is: lawsonmc.servegame.com:25800

Thanks

Reply
Scott on March 30, 2016 at 6:06 pm

Gus,

Thank you for the great tutorial – even us newbies to Pi and ssh can follow along.

I’ve got the 1.9 server running on a RPi3 and all seems to be going fine, but I’ve got a few questions I have not found answers to in the tutorial or here in the comments.

The only things I did differently in the install was that:
1) I did not create the auto-start script.
2) I was not allowed to Overclock

1) Each time I restart the server, it stops, with the message “Failed to load eula.txt. You need to agree to the EULA…” When I again edit the eula.txt file, it contains the TRUE setting I had earlier edited. Any idea why it isn’t loading/recognizing the edited file?

2) On my PC install of Minecraft, I can delete(or rename) the “world” directory and the game will create a new world to play. When I do the same thing on the Pi install, the server fails. Apparently there is something different in the Pi versions’ “world” directory. What is the best way to create a “new world” to play on this server?

3) During gameplay, I’m getting a little hesitation in movement and then seeing Terminal warnings that “UserName” moved too quickly! Since I’m not running the server 24/7, would the solution be to bump up the memory from the recommended setting of 16?

4) Can I just replace the whitelist.json file with the same document from a PC server version? – or, like renaming the “world” folder, is there something different about these servers that would cause a fail?

Thanks again for this and your other projects.

Scott

Reply
Richard on March 23, 2016 at 9:42 pm

Just installed the server on my Pi 3 following your guide. All went well apart from a few issues. Firstly, plugins only seemed to be detected if they were in /home/minecraft/plugins/plugins, I get an error if I try the ‘wstats’ command from within the server environment, and I can’t actually access the server via Minecraft PE on our phones or tablets. I’ve got the IP address correct, and the port is 25565 (rather than the default port that Minecraft PE assumes (19132)). The server is running on the Pi so I’m not sure what else to try?

Reply
1. Steve on March 25, 2016 at 7:14 pm
  
  Hi Richard, this installation guide is for PC version of Minecraft. You won’t be able to join Pocket Edition clients.
  
  Reply
Jeff on March 7, 2016 at 6:49 am

This tutorial is great and easy to follow!

As evidence, I was able to hand my 11 year old, who had never worked with Linux / Unix, a Raspberry Pi2 and point him at this tutorial. By the end of the day he had a fully functional Minecraft 1.9 server.

The only places that I had to assist was that I pre-installed putty and winscp on his computer and showed him how to use them. Then for the steps themselves he had issues with steps 14 and 15. For step 14 he missed the –rev 1.9 switch, and thus made a Minecraft 1.8 server. For step 15 he was afraid to proceed because he didn’t see spigot.jar. He didn’t realize the steps were referring to spigot-1.8.8.jar or spigot-1.9.jar. He was also able to easily follow the Boot on Startup section, and the Editing the Minecraft properties section.

Reply
J on March 4, 2016 at 5:34 pm

1. Is it necessary to download any version of java when java is already installed?

2. Does that Chunks plugin need to be ran with java or does it do whatever it needs to do from the plugins folder? I tried running it and couldn’t get it to go.

Reply