Unleash Your Minecraft Empire: A Turnkey Guide to Running Multiple Servers on Proxmox/Unraid

Setting Up MineOS Turnkey on Proxmox for Multiple Minecraft Servers

Table of Contents

  1. Proxmox Preparation
  2. MineOS Turnkey Installation
  3. Initial Configuration
  4. Multiple Server Setup
  5. Network Configuration
  6. Performance Optimization

Proxmox Preparation

  1. System Requirements

    • CPU: x86_64 architecture required
    • RAM: Minimum 8GB (16GB+ recommended)
    • Storage: SSD recommended
    • Network: Gigabit Ethernet recommended
  2. Download MineOS Turnkey

MineOS Turnkey Installation

  1. 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
    
  2. 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

  1. 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
    
  2. Update System

    apt update
    apt upgrade -y
    
  3. Configure Backup Location

    mkdir -p /var/backups/minecraft
    chmod 755 /var/backups/minecraft
    

Multiple Server Setup

  1. Access Web Interface

  2. 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
    
  3. 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
    
  4. 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

  1. 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
    
  2. 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

  1. 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
    
  2. 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
    
  3. System Monitoring

    • Use built-in Webmin monitoring
    • Enable MineOS server statistics
    • Monitor through Proxmox interface

Maintenance Procedures

  1. Regular Backups

    # Configure in Webmin:
    Scheduled Backups:
    - World files
    - Server configurations
    - Player data
    
  2. Update Schedule

    Weekly:
    - Check for Minecraft updates
    - System updates (apt upgrade)
    
    Monthly:
    - Review logs
    - Clean old backups
    - Check resource usage
    
  3. 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 htop for 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