| minecraft-setup.png | ||
| README.md | ||
| setup_bedrock.sh | ||
| setup_minecraft_lxc.sh | ||
🖥️ Minecraft Server on Proxmox
This repository provides a guide and an automated script to set up a Minecraft server on Proxmox using either a Virtual Machine (VM) or an LXC container.
📌 Features
✅ Automated installation of Minecraft Java/Bedrock servers
✅ Works with Proxmox VM or LXC container
✅ Performance optimizations included
✅ Customizable settings
🚀 Installation Guide (Proxmox VM)
1️⃣ Create a Proxmox VM
-
Open Proxmox Web Interface → Click on "Create VM"
-
General Settings:
- Name:
Minecraft-Server
- Name:
-
OS Selection:
- Use a Debian 11/12 or Ubuntu 22.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(for best performance)
-
CPU & RAM:
- 2 vCPUs (4 recommended)
- 4GB RAM (8GB recommended)
-
Network:
- Model: VirtIO (paravirtualized)
- Enable QEMU Guest Agent after installation
-
Finalize the installation and run:
apt update && apt install -y qemu-guest-agent
2️⃣ 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
- Name:
-
Template Selection:
- Choose a Debian 11/12 template.
-
CPU & RAM:
- 4GB RAM (8GB recommended)
- 2 vCPUs (4 recommended)
-
Disk & Storage:
- 10GB+ Storage
- Storage Type:
ext4(recommended for LXC)
-
Advanced Settings:
- Enable "Nestling" under Features (for Java support)
-
Finalize and start the container.
2️⃣ 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
🔧 Configuration & Server Management
-
Edit Server Properties:
nano /opt/minecraft/server.properties -
Start/Stop the Server:
systemctl start minecraft systemctl stop minecraft -
Check Logs:
tail -f /opt/minecraft/logs/latest.log
🌐 Port Forwarding for External Access
To allow external players to connect, open port 25565 on your firewall:
ufw allow 25565/tcp
For LXC containers, use NAT forwarding:
iptables -t nat -A PREROUTING -i vmbr0 -p tcp --dport 25565 -j DNAT --to-destination 192.168.1.100:25565
🎮 Bedrock Server (Windows & Console Support)
If you want to run a Minecraft Bedrock Server (for Windows, Xbox, and mobile players), use the following script:
wget https://raw.githubusercontent.com/TimInTech/minecraft-server-Proxmox/main/setup_bedrock.sh
chmod +x setup_bedrock.sh
./setup_bedrock.sh
🤝 Contribute
- Found a bug? Open an Issue
- Want to improve the script? Submit a Pull Request
🚀 Happy gaming! 🎮
