2025-06-23 10:58:40 +02:00

4.8 KiB

Raw Permalink Blame History

🧱️ Minecraft Server on Proxmox 🌍

This repository provides a guide and automated scripts to set up a Minecraft server on Proxmox using either a Virtual Machine (VM) or an LXC container.

🔗 Support This Project 💎

If you find this guide helpful, consider purchasing through this affiliate link: ⛏️ NiPoGi AK1PLUS Mini PC – Intel Alder Lake-N N100 Using this link supports the project at no additional cost to you. Thank you! 🙌

📌 Features 📜

✅ Automated installation of Minecraft Java/Bedrock servers ✅ Works with Proxmox VM or LXC container ✅ Performance optimizations included (RAM allocation, CPU prioritization) ✅ Customizable settings (world generation, plugins, mods) ✅ Troubleshooting guide included for common issues

💎 Installation Guide (Proxmox VM) 🖥️

1️⃣ Create a Proxmox VM 💠

Open Proxmox Web Interface → Click on "Create VM"
General Settings:
- Name: Minecraft-Server
OS Selection:
- Use a Debian 11/12 or Ubuntu 24.04 ISO image
System Configuration:
- BIOS: OVMF (UEFI) or SeaBIOS
- Machine Type: q35 (recommended)
Disk & Storage:
- 20GB+ Storage (depending on world size)
- Storage Type: virtio (recommended)
CPU & RAM:
- 2 vCPUs (recommended: 4)
- 4GB RAM (recommended: 8GB)
Network:
- Model: VirtIO
- Enable QEMU Guest Agent after installation

2️⃣ Install Dependencies ⚙️

apt update && apt upgrade -y  
apt install -y curl wget nano screen unzip git openjdk-21-jre-headless

3️⃣ Run the Minecraft Server Setup Script ⛏️

wget https://raw.githubusercontent.com/TimInTech/minecraft-server-Proxmox/main/setup_minecraft.sh  
chmod +x setup_minecraft.sh  
./setup_minecraft.sh

🛠️ Installation Guide (Proxmox LXC Container) 📆

1️⃣ Create a Proxmox LXC Container 🧱️

Open Proxmox Web Interface → Click on "Create CT"
General Settings:
- Name: Minecraft-LXC
- Set root user password
Template Selection:
- Choose a Debian 11/12 or Ubuntu 24.04 template
Resources:
- CPU: 2 vCPUs (recommended: 4)
- RAM: 4GB (recommended: 8GB)
- Disk Storage: 10GB (recommended: 20GB)
Network Settings:
- Network Device: eth0
- Bridge: vmbr0 (adjust as needed)
- IPv4: Static (e.g. 192.168.0.222/24)
- Gateway (IPv4): typically 192.168.0.1
- Firewall: Enable (optional)
Advanced Settings:
- Enable "Nesting" (required for Java & systemd)
- Disable "Unprivileged Container" if needed

2️⃣ Install Required Dependencies ⚒️

apt update && apt upgrade -y  
apt install -y curl wget nano screen unzip git openjdk-21-jre-headless

3️⃣ Run the LXC Setup Script 🛠️

wget https://raw.githubusercontent.com/TimInTech/minecraft-server-Proxmox/main/setup_minecraft_lxc.sh  
chmod +x setup_minecraft_lxc.sh  
./setup_minecraft_lxc.sh

🔧 Post-Installation Notes

✅ Can I install this as a non-root user?

Yes – root is only needed during setup (e.g. to create the minecraft user). After installation, all operations (start, stop, update) can and should be done as the minecraft user.

🎮 How do I access the Minecraft console?

sudo -u minecraft screen -r

If needed:

sudo -u minecraft screen -ls
sudo -u minecraft bash /opt/minecraft/start.sh

🔄 How do I update the server?

Java Edition:

cd /opt/minecraft
sudo -u minecraft ./update.sh

If it's missing:

sudo nano /opt/minecraft/update.sh

Paste:

#!/bin/bash
wget -O server.jar https://api.papermc.io/v2/projects/paper/versions/1.20.4/builds/416/downloads/paper-1.20.4-416.jar

Then:

sudo chmod +x /opt/minecraft/update.sh

Bedrock Edition:

Manual update required – download the latest .zip from the official site and replace the old one. (Due to licensing restrictions, automatic download is not included.)

🔍 Troubleshooting & Solutions 🚩

1️⃣ Java Version Error

apt install -y openjdk-21-jre-headless
systemctl restart minecraft

2️⃣ Missing `start.sh`

cd /opt/minecraft
nano start.sh