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.

Teacher Notes

Teachers! Did you use this instructable in your classroom?
Add a Teacher Note to share how you incorporated it into your lesson.

Step 1: Materials

Raspberry Pi: Model B

USB Power Adapter

Ethernet Cable

SD Card(At least 4GB)

Soft-float Debian "wheezy"( Can be found here: http://www.raspberrypi.org/downloads )

Imaging software (ex: Win32DiskImager: http://sourceforge.net/projects/win32diskimager )

SSH Client ( ex: Putty: http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html )

Step 2: 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

Download the Soft-float Debian “wheezy” image zip file (http://www.raspberrypi.org/downloads) 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, http://sourceforge.net/projects/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

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.

Step 5: Configure Internet Access

1. Connect the Pi to a local network via Ethernet cable.  Green and yellow lights should appear on the Pi board itself.
2. Open a Terminal by double clicking on the desktop icon ‘LXTerminal’
3. Type ‘ifconfig’ to ensure and press Enter that the Pi has a valid IP address
4. Type ‘ping’ and Press Enter to ensure that the Pi can reach external servers.
     a. (Press CTRL+C to stop Ping and any other programs running in the current terminal)

Step 6: SSH to Raspberry Pi

Now you are fully setup with a working Raspberry Pi. You are ready to SSH into it and start the install.

1. Open Putty
2. Enter your PI's IP address
3. Login using Username: Pi Password: Raspberry
4. You have successfully logged into your headless Pi

Step 7: Install Java

Download Java to the Raspberry PI

    wget --no-cookies --header "Cookie: gpw_e24=http%3A%2F%2Fwww.oracle.com%2F" "http://download.oracle.com/otn-pub/java/jdk/7u25-b15/jdk-7u25-linux-arm-sfp.tar.gz"

Then we need to make folder in wich should we put our files:

     sudo mkdir -p -v /opt/java

Then we unzip Java files using the following command:

     tar xvzf ~/(Name of your Java package file).gz

Then we move Java files into /opt/java:

     sudo mv -v ~/jdk1.7.0_06 /opt/java

Then we need to tell that new JVM has been installed on Raspberry Pi:

     sudo update-alternatives --install "/usr/bin/java" "java" "/opt/java/jdk1.7.0_06/bin/java" 1

     sudo update-alternatives --set java /opt/java/jdk1.7.0_06/bin/java

Then, this command should work and give this result:

     java -version

Step 8: Install the Minecraft Server

Make a Folder for the Server
    mkdir MCServer
Move into the folder
    cd MCServer
Download the Server
    wget https://s3.amazonaws.com/MinecraftDownload/launcher/minecraft_server.jar
Start it up!
    java -Xmx256M -Xms256M -jar minecraft_server.jar

Step 9: Finished

Congratulations you have just installed a fully functional Minecraft Server on to the Raspberry Pi! It is possible to log in and play with friends now. 

You have to Port Forward just as any other server but the hard part is over.

Be the First to Share


    • Made with Math Contest

      Made with Math Contest
    • Multi-Discipline Contest

      Multi-Discipline Contest
    • Robotics Contest

      Robotics Contest

    149 Discussions


    2 months ago

    What minecraft server version does it install

    1 reply

    Reply 3 days ago

    I'm uhh... gonna let you find that one out


    3 years ago

    where do i find the jave package name in step 7 ?

    2 replies

    Reply 2 years ago



    Reply 2 years ago

    Hi KafmanV,

    If you can't do the Java part and having issues with the name or something, you can just skip it because raspberry pi has it's own Java program.


    2 years ago

    What different steps, if any, should I take for the Raspberry Pi 3? Java? Wrong link it says.

    1 reply

    Reply 2 years ago



    3 years ago

    On step 5: 'ifconfig' should be 'ipconfig', right?

    3 replies

    Reply 2 years ago

    ifconfig is correct. Most Linux distros use this command unlike winblows *cough* which makes use of the ipconfig command.


    Reply 3 years ago

    I think its right. On linux, the command is ifconfig, not ipconfig like windows.


    3 years ago

    So the version of Minecraft that runs on the PC must be the same version that runs on the server?

    How much data goes in and out of the Pi during a typical game? Are we talking small status like updates, or huge continous data streams that contain all the scene/environment graphic information?

    Aside from a slow gameplay, is it possible to run a minecraft server on an arduino (with an ethernet shield) ?

    2 replies

    Reply 3 years ago

    @snoop911. The client and server must be the same version or you wont be able to connect.

    as for data all online games that connect to a server have a constant back and forth flow of data. its not huge but it it continuous.

    and as for question 3 a minecraft server can not be run on an arduino. an arduino is at its core just on and off switches that are programmable to function in a specific way. an ethernet shield only allows for trigger signals to be received over that medium and programed outputs can be replied.

    tl;dr 1;yes. 2.alot. 3.no. never.


    Reply 3 years ago

    Thanks. Since posting my question, I found an example of minecraft running on an 8-bit avr!



    From the video, it looks like the outputs of the device can be controlled from the gameplay! Any thoughts on how this server works?

    Does all the map/environment reside on the server? If so, I would imagine inputs to the device can also be represented in the game, maybe using a redstone lamp?


    3 years ago

    how do i find the ip adress to connect to it


    3 years ago

    A few comments:

    1. These basic
    instructions work well with a Raspberry Pi 2 model B running raspbian
    jessie. I suggest using the flags "-Xms256M" and "-Xmx 768M" or larger
    on the java command to start the server.

    2. These instructions DO
    NOT WORK with Minecraft PE. To setup a Minecraft PE server on a
    raspberry pi, you will need to install "pocketmine" which is not
    affiliated with Mojang and is done at your own risk.

    3. Minecraft
    (especially Minecraft PE) servers are sensitive to which version of
    Minecraft (PE) you are running on your computer/device. Be sure that
    your device software version is compatible with the server software version you are