TC
Troy’s Tech Corner
build techMar 15, 202612 min read

Build a Minecraft Server with Raspberry Pi: Complete Setup Guide

Create your own private Minecraft world that friends and family can join from anywhere. Perfect for learning server management while providing endless entertainment and creative possibilities.

What You're Building

A complete Minecraft server that:

  • Hosts your own worlds with custom rules and settings
  • Supports multiple players connecting from different devices
  • Runs 24/7 for persistent world building
  • Includes world backup and management tools
  • Costs much less than commercial hosting services
  • Teaches server administration and networking concepts
  • Provides safe gaming environment for family and friends

Difficulty: ⭐⭐⭐ Intermediate
Time Required: 2-4 hours setup + ongoing world management
Cost: $80-150 depending on Pi model and storage
Player Capacity: 2-10 players depending on Pi model

What You'll Need

Required Hardware

[!IMPORTANT] A Raspberry Pi 4 (8GB) is strongly recommended for the best performance. A Pi 3 B+ will struggle with more than 1-2 players.

Raspberry Pi

  • Raspberry Pi 4 (8GB) – Strongly recommended for best performance
  • Raspberry Pi 4 (4GB) – Minimum for 2-4 players

Storage

  • SanDisk 128GB microSD – For operating system
  • External SSD strongly recommended for world storage
  • Minimum 32GB for OS + Minecraft server

Network and Power

  • Reliable internet connection (upload speed important)
  • Ethernet cable (much better than WiFi for servers)
  • Official power supply (critical for stability)
  • Small UPS – Protects against power outages and world corruption

Cooling

  • Pi 4 Case with Fan – Essential for 24/7 operation
  • Active cooling prevents thermal throttling during intensive gameplay

Optional Enhancements

Better Storage

  • USB 3.0 SSD for world files (much faster than SD card)
  • Large capacity for multiple worlds and backups

Network Improvements

  • Static IP address configuration
  • Port forwarding for external access
  • VPN server for secure remote access

Understanding Minecraft Server Requirements

Performance Expectations by Pi Model

Raspberry Pi 4 (8GB) - Recommended:

  • Players: 6-10 simultaneous players comfortably
  • World size: Large worlds with extensive builds
  • Mods: Light modding possible (Fabric recommended)
  • Render distance: 8-12 chunks per player
  • Performance: Smooth gameplay for most activities

Raspberry Pi 4 (4GB) - Minimum:

  • Players: 2-4 simultaneous players
  • Performance: Good for family servers, small friend groups

Server Software Options

Paper MC (Recommended):

  • Best performance with optimization features
  • Plugin support for additional functionality
  • Regular updates and active development

Spigot:

  • Good performance with plugin ecosystem

Vanilla (Official):

  • Authentic experience exactly like single-player
  • Higher resource usage than optimized servers

Step-by-Step Setup Guide

Step 1: Prepare Your Raspberry Pi

Install and configure Raspberry Pi OS following our initial setup procedures.

Essential optimizations for Minecraft server:

# Update system completely
sudo apt update && sudo apt full-upgrade -y

# Install Java (required for Minecraft)
sudo apt install openjdk-17-jdk -y

# Verify Java installation
java -version

Configure memory and swap:

# Increase swap file for better performance
sudo dphys-swapfile swapoff
sudo nano /etc/dphys-swapfile
# Change: CONF_SWAPSIZE=2048
sudo dphys-swapfile setup
sudo dphys-swapfile swapon

Step 2: Install Minecraft Server

Create server directory:

# Create dedicated directory
mkdir ~/minecraft-server
cd ~/minecraft-server

# Create server management scripts
mkdir scripts backups logs

Download Paper MC server (recommended):

# Download latest Paper MC (check papermc.io for latest version)
wget https://api.papermc.io/v2/projects/paper/versions/1.20.4/builds/497/downloads/paper-1.20.4-497.jar

# Rename for easier management
mv paper-1.20.4-497.jar server.jar

# Make executable
chmod +x server.jar

Initial server configuration:

# Create start script
nano start.sh

Add the following content:

#!/bin/bash
cd /home/pi/minecraft-server

# Server startup with optimized settings
java -Xms2G -Xmx3G \
  -XX:+UseG1GC \
  -XX:+ParallelRefProcEnabled \
  -XX:MaxGCPauseMillis=200 \
  -jar server.jar nogui

echo "Server stopped. Press any key to exit."
read
# Make start script executable
chmod +x start.sh

Step 3: First-Time Server Setup

Accept EULA and initial configuration:

# First run (will fail - this is expected)
./start.sh

# Accept the EULA
nano eula.txt
# Change: eula=true

# Configure server properties
nano server.properties

Essential server.properties settings:

# Basic server settings
server-name=Your Pi Minecraft Server
motd=Welcome to our Raspberry Pi Minecraft Server!
max-players=8
difficulty=normal
gamemode=survival

# Performance settings
view-distance=8
simulation-distance=6

Step 4: Network Configuration

Set up static IP (recommended):

# Edit network configuration
sudo nano /etc/dhcpcd.conf

# Add at the end (adjust for your network):
interface eth0
static ip_address=192.168.1.100/24
static routers=192.168.1.1
static domain_name_servers=192.168.1.1 8.8.8.8

[!WARNING] Exposing your server to the internet using Port Forwarding carries security risks. Consider setting up a VPN access instead for a safer connection.

Step 5: Create Auto-Start Service

Create systemd service for automatic startup:

sudo nano /etc/systemd/system/minecraft.service
[Unit]
Description=Minecraft Server
After=network.target

[Service]
Type=forking
User=pi
WorkingDirectory=/home/pi/minecraft-server
ExecStart=/bin/bash /home/pi/minecraft-server/start.sh
ExecStop=/usr/bin/pkill -f "java.*server.jar"
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Enable and test the service:

# Enable auto-start
sudo systemctl enable minecraft.service

# Start service
sudo systemctl start minecraft.service

# Check status
sudo systemctl status minecraft.service

Security and Access Control

Whitelist Configuration

Enable whitelist for private server:

# Edit server properties
nano ~/minecraft-server/server.properties
# Set: white-list=true

# Add players to whitelist (server must be running in-game)
/whitelist add PlayerName

Frequently Asked Questions

Can Raspberry Pi 4 handle a Minecraft server?

Yes! Pi 4 with 8GB RAM can comfortably support 6-10 players. Performance depends on world complexity and player activity.

How much internet speed do I need?

Upload speed is most important: 1 Mbps for every 2-3 players. Download speed is less critical.

What happens if the power goes out?

Without UPS: World corruption is possible. With UPS: Server shuts down safely, and worlds are protected.

Conclusion: Your Private Minecraft Universe

Building a Minecraft server on Raspberry Pi creates more than just a game server—it's a learning platform, community hub, and creative playground all in one compact, efficient package.

Your Minecraft server teaches valuable technical skills while providing endless entertainment. From basic Linux commands to network security, you're learning real-world IT skills that apply far beyond gaming!

Enjoyed this guide?

Get more beginner-friendly tech explanations and guides sent to your inbox.

No spam. Unsubscribe at any time. We respect your privacy.

Related Guides