Setting Up MineOS Turnkey on Proxmox for Multiple Minecraft Servers
Table of Contents
- Proxmox Preparation
- MineOS Turnkey Installation
- Initial Configuration
- Multiple Server Setup
- Network Configuration
- Performance Optimization
Proxmox Preparation
-
System Requirements
- CPU: x86_64 architecture required
- RAM: Minimum 8GB (16GB+ recommended)
- Storage: SSD recommended
- Network: Gigabit Ethernet recommended
-
Download MineOS Turnkey
- Download MineOS Turnkey ISO (~700MB) from the link below
- 1.2.2-20241107T065959Z-001.zip » HHF Technology
- Upload ISO to Proxmox storage
Select: local (pve) > ISO Images Upload: MineOS-Turnkey.iso
MineOS Turnkey Installation
-
Create VM in Proxmox
General: - Node: your-node - VM ID: 100 (or available ID) - Name: mineos-turnkey OS: - Use CD/DVD: MineOS-Turnkey.iso - Type: Linux - Version: Debian 11 System: - Machine: q35 - BIOS: OVMF (UEFI) - EFI Storage: local-lvm - SCSI Controller: VirtIO SCSI Disks: - Bus/Device: SCSI - Storage: local-lvm - Disk size: 32GB minimum - Cache: Write back CPU: - Cores: 4 (adjust as needed) - Type: host Memory: - Size: 8GB minimum - Ballooning Device: Disabled Network: - Bridge: vmbr0 - Model: VirtIO -
Install MineOS Turnkey
- Start VM and access console
- Follow Turnkey installation prompts:
Set root password Set MySQL password Set webmin admin password Configure email settings (optional)
Initial Configuration
-
First Login
Web Interface: URL: https://your-server-ip:8443 Default credentials will be shown in console after installation SSH Access: ssh root@your-server-ip -
Update System
apt update apt upgrade -y -
Configure Backup Location
mkdir -p /var/backups/minecraft chmod 755 /var/backups/minecraft
Multiple Server Setup
-
Access Web Interface
- Navigate to https://your-server-ip:8443
- Login with credentials set during installation
-
Create Minecraft Servers
For each server: 1. Click "Create New Server" 2. Configure unique settings: - Server Name - Port Number (increment from 25565) - Memory Allocation - Minecraft Version -
Server Configuration Template
# server.properties server-port=25565 # Increment for each server max-players=20 view-distance=10 spawn-protection=16 allow-nether=true difficulty=normal -
Resource Allocation
Server 1 (Main): Port: 25565 RAM: 4GB CPU Cores: 2 Server 2: Port: 25566 RAM: 2GB CPU Cores: 1 Server 3: Port: 25567 RAM: 2GB CPU Cores: 1
Network Configuration
-
Turnkey Firewall Configuration
# Edit /etc/csf/csf.conf # Allow Minecraft ports TCP_IN = "8443,25565:25570" TCP_OUT = "8443,25565:25570" # Restart firewall csf -r -
Port Forwarding
Router/Firewall Settings: - TCP 8443 (Web Interface) - TCP 25565 (Minecraft Server 1) - TCP 25566 (Minecraft Server 2) - TCP 25567 (Minecraft Server 3)
Performance Optimization
-
Java Settings per Server
# Edit in MineOS Web Interface for each server java_xms=1G java_xmx=4G # Additional JVM arguments -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:+AlwaysPreTouch -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=8M -XX:G1ReservePercent=20 -
Scheduled Tasks
# Automatic backups (via webmin) 0 4 * * * /usr/local/games/minecraft/backup.sh # Memory cleanup 0 */6 * * * sync; echo 3 > /proc/sys/vm/drop_caches -
System Monitoring
- Use built-in Webmin monitoring
- Enable MineOS server statistics
- Monitor through Proxmox interface
Maintenance Procedures
-
Regular Backups
# Configure in Webmin: Scheduled Backups: - World files - Server configurations - Player data -
Update Schedule
Weekly: - Check for Minecraft updates - System updates (apt upgrade) Monthly: - Review logs - Clean old backups - Check resource usage -
Recovery Procedures
- Keep latest known-good backup
- Document all custom configurations
- Maintain server-specific restore points
Additional Notes
- MineOS Turnkey includes Webmin for additional server management
- Use SFTP for file transfers (available by default)
- Monitor server logs through web interface
- Utilize MineOS’s built-in server templates
- Keep system updated using apt package manager
Troubleshooting
- Check logs in
/var/log/mineos - Monitor system resources with Webmin
- Use
htopfor real-time resource monitoring - Check network connectivity with
netstat -tulpn
Remember to:
- Regularly backup all server data
- Monitor system resources
- Keep MineOS and system updated
- Document any custom configurations
- Test backups periodically