Picture of Raspberry Pi: Minecraft Server
These instructions will provide you with a list of requirements and steps for configuring your own Minecraft server using the Raspberry Pi. Once complete, you will be able to access and play with your friends from across the world on your Raspberry Pi.
Remove these adsRemove these ads by Signing Up

Step 1: Materials

Picture of Materials
Raspberry Pi: Model B

USB Power Adapter

Ethernet Cable

SD Card(At least 4GB)

Soft-float Debian "wheezy"( Can be found here: )

Imaging software (ex: Win32DiskImager: )

SSH Client ( ex: Putty: )

Step 2: Development Environment

Picture of Development Environment
PC with Internet connection & SD card reader

Additional wired Internet connection

Extra USB Keyboard

Monitor (with HDMI port, or adapter)

HDMI cable (and adapter, if necessary)

Step 3: Download and Burn Linux Distribution Image to SD Card

Picture of Download and Burn Linux Distribution Image to SD Card
Download the Soft-float Debian “wheezy” image zip file ( and unzip it into a directory of your choice.

     Linux distribution used: 2013-05-29-wheezy-armel

Obtain imaging software that will support SD cards

     Ex: Win32DiskImager,

Burn an image of the linux distribution to SD card:

1. Open Win32 Disk Imager
2. Click on Directory icon and navigate to downloaded and unzipped image (.IMG) and select ‘Write’ … confirm “Yes” when prompted
3. When complete, a window will pop up saying “Write Successful”.  Click OK.  Click Exit.
4. Remove SD card.

Step 4: Initial Boot and Configuration of the Raspberry Pi

Picture of Initial Boot and Configuration of the Raspberry Pi
1. Insert SD card into Pi in without a power supply
2. Ensure that HDMI, keyboard and mouse are connected properly
3. Connect the 5V power supply
4. The Pi should boot as a list of processes and applications begin filling the screen
5. A blue screen appears with ‘Raspi-config’ and several menu options
6. Arrow down to Select ‘expand_rootfs’ and press Enter
7. ‘Root Partition has been resized’, press Enter.
8. Arrow down to ssh
9. Enable SSH
10. Reboot
11. If all boots correctly then you are ready to start the install.
1-40 of 94Next »
DarrenS216 days ago

I've tried running minecraft on my B+ and it just crashes all the time, one person connects and crash. Pretty sure the CPU isn't strong enough, even over clocked at 1Ghz turbo.

EthanH326 days ago

Is there anyway I could string several of these up to make a more powerful server??

yes you can, there are people that dtacked 30-60 pies and connected to interact with each other but it gets expensive
dasher12425 days ago


ghost10728 days ago

thi was sooo helpful thx

I did the "wget" command and after a few lines it says "Connecting to s3 (s3)||:443... failed: Connection refused." What should I do?

the URL format has changed:

You can find it by examining the link on the Minecraft web page for the server jar file download

try the 1.8 version


dudelkingL2 months ago

No way. This the vanilla will hardly run on any RPi

Spigot will outperform any other server here (search for spigotMC)

I tested it on my B+ and it works fine. Just don't try it on an A/A+. (remember to change the heap to 496M to maximize ram usage)

frankrams1 month ago

I've tried both Spigot and CraftBukkit (built on a Windows 7 box with BuildTools and FTP'ed) on the new Raspberry Pi 2. Both run pretty well (especially compared to my old Raspberry Pi B. I've tried a couple of FTB's but the big ones have problems with Java. The FTPlite2 runs pretty well.

I must say though, I haven't had anyone but myself on the server.

If you could test I would like to know how many players can be on a minecraft server on the pi 2.

Nice Tutorial! For the Banana Pi it works also after install an current version of the g++ compiler:

YourN2 months ago

Would be great for the new raspberry pi 2!

I am installing it right now, but Java instruction above did not work, i used these:

sudo apt-get update

sudo apt-get install openjdk-7-jdk

To install Java, it worked

Niels W.K2 months ago

We (my son and I) did some testing with a custom made MineCraft server called MCServer - and it works great on the Raspberry Pi B (Classic). It performed well, and has a WebAdmin interface as well.

According to developer, It's written completely in C++, should be fast, lightweight and awesome replacement for Vanilla.

Try search for MC-Server.

Di Immortales4 months ago

when i to get 1.7.10 it gives me error 403 forbidden , i think its 'cause of Microsoft buying Mojang

why would that have anything to do with that Mojang and Microsoft haven't even done it yet

they already have
Ah-che3 months ago

Ok ! It's working but verry laggy with 2 players in server . Sorry but server of MC is too complicated work for raspi....

arpruss Ah-che2 months ago

I wonder if the speed might not be fine in the new pi version.

sunfish622 months ago

There are a few points that should be updated on this instruction list.

First, if you install a raspbian image from after September 2013, you do NOT need to download and install Java. It is already included.

Next, the server download listed is for server 1.5.2. I note that MC is at 1.8.1. However, it is not clear whether 1.5.2 is the only version that will run
comfortably on RPi. As I can see it, more recent servers use more
resources, but I could be totally wrong about that. Readers can go to to find different server releases. If you do use this server, your players have to know to use the older client settings.

Third, as of December 2013 Mohjang has implemented an EULA agreement process that you MUST handle. You have to edit eula.txt (in the folder to which you downloaded the jar file) and change the line that says "eula=false" to "eula=true". Otherwise, the server craps out.

Fourth, if you DO download a different version, the jar file will include the
version number in it (e.g. minecraft_server.1.8.1.jar). Moreover, using
the 256M figures will cause the server to bark at you. It will recommend
1024M, but I am not sure what numbers to use on the limited RPi

Finally, you are likely to see "Can't keep up" errors on the console. It is not clear whether these are problematic or not (searches online led me to different opinions on the matter), but readers should at least be prepared for them.

SamL33 months ago

This is ridiculous. What is the name of my "Java package file"?

Joshuay3 months ago

everything works fine until i run the actual program, then it gives me this.

Exception in thread "Thread-3" java.lang.NullPointException

at net.minecraft.server.MinecraftServer.a(SourceFile:252)

at net.minecraft.server.MinecraftServer.k(SourceFile:276)


jakobk13 months ago

Hi Guys, I have a problem that I hope you can help me solve.

I'm trying to run the official Mojang minecraft server on the PI B+, using the:


And following this instruction.

The newest release of Rasbian has Java installed so I skipped that part, when I do the "java -version" everything looks perfect.

I do the rest of the guide and everything looks good, but when I try to launch the server using the command: "sudo java -Xms256M -Xmx496M -jar minecraft_server.jar nogui" I get the following error:

"error occurred during initialization of vm too small initial heap"

I've tried decreasing the memory allocated to the server but no succes.

Do you have any ideas or solutions?

SahirB3 months ago

How do you make a minecraft server?

m about to start using raspberry pi but can you play minecraft by going on to the mine website and putting user and pass and downloading linux version. can u or can u not do this

It will probably fail hard as the pi editon of minecraft is specificly to run on the pi's specs as the windows mac and linuix have higher requirements which is why the pi editions made for the pi
EddiKarp.6 months ago

Hey, I set up the server but i cant connect to it. Keeps telling me "Internal Exception: Connection reset by peer help please!?

Sorry if im a bit late. Im new. Try restarting the server because i remember getting that message when i was playing minecraft on my mac and i had to wait till the server owner would restart the server :) hope i helped.
JeremyG14 months ago

This is like the coolest thing ever! I will defiantly try it out if I can.

MiguelM24 months ago

to get the last updated version go to "" look for the .jar version, right click on it and select copy link location ( should be )

pibeginer7 months ago

when i use the command :


it says 404 not found help plzz

maboy1 year ago
Can you play from the pi?
im3733 maboy1 year ago
I wouldn't expect so. Running a Minecraft server takes significantly less memory than playing it. Most of this is due to the amount of memory used for rendering everything.

Mojang has actually posted system requirements here:

They specify a minimum of 2GB of RAM for running the game, with a recommendation of 4GB of RAM, whereas the Raspberry Pi tops out at only 512MB, while you could theoretically use some of the SD card or external storage as swap space, this isn't recommended as it will burn out those sectors of the card/disk faster, not to mention the speed of the swap space isn't that great.

You can play Minecraft from the pi, but it's only the pi edition, which doesn't let you on servers

im3733 im37331 year ago
That said, there is a Minecraft Pi edition that is designed to work on the Raspberry Pi, however, I don't know if it supports server play (though my suspicion would be that it does).

If you go to, they now have a dedicated Forum category for the Raspberry Pi.

What should the Java Package be named?

Draftmission10 months ago

Make sure you use the correct ram for your pi:

Memory256 MB[4] (Model A)
256 MB (Model B rev 1)
512 MB (Model B rev 2)[5]


Modify the command accordingly:
java -Xmx256M -Xms256M -jar minecraft_server.jar
java -Xmx256M -Xms256M -jar minecraft_server.jar
java -Xmx512M -Xms512M -jar minecraft_server.jar

Please note: Newer server jar includes version nr. in file name
1.7.9 = java -Xmx___M -Xms___M -jar minecraft_server.1.7.9.jar

1-40 of 94Next »