Files
homelab-optimized/hosts/vms/seattle/pufferpanel
Gitea Mirror Bot e71c8ddb4b
Some checks failed
Documentation / Build Docusaurus (push) Failing after 5m5s
Documentation / Deploy to GitHub Pages (push) Has been skipped
Sanitized mirror from private repository - 2026-04-20 01:24:42 UTC
2026-04-20 01:24:42 +00:00
..

PufferPanel - Game Server Management

📋 Overview

PufferPanel is a web-based game server management panel that provides an easy-to-use interface for managing game servers, including Minecraft, Garry's Mod, and other popular games.

🔧 Service Details

Property Value
Service Type System Service
Binary Location /usr/sbin/pufferpanel
Configuration /etc/pufferpanel/
Data Directory /var/lib/pufferpanel/
Web Port 8080
SFTP Port 5657
Process User pufferpanel

🌐 Network Access

  • Web Interface: http://seattle-vm:8080
  • SFTP Access: sftp://seattle-vm:5657
  • Reverse Proxy: Configured via Nginx (check /etc/nginx/sites-enabled/pufferpanel)

🚀 Management Commands

Service Control

# Check status
sudo systemctl status pufferpanel

# Start/stop/restart
sudo systemctl start pufferpanel
sudo systemctl stop pufferpanel
sudo systemctl restart pufferpanel

# Enable/disable autostart
sudo systemctl enable pufferpanel
sudo systemctl disable pufferpanel

Logs and Monitoring

# View logs
sudo journalctl -u pufferpanel -f

# Check process
ps aux | grep pufferpanel

# Check listening ports
ss -tlnp | grep -E "(8080|5657)"

📁 Directory Structure

/etc/pufferpanel/
├── config.json        # Main configuration
└── ...

/var/lib/pufferpanel/
├── servers/           # Game server instances
├── templates/         # Server templates
├── cache/            # Temporary files
└── logs/             # Application logs

⚙️ Configuration

Main Config (/etc/pufferpanel/config.json)

  • Web interface settings
  • Database configuration
  • SFTP server settings
  • Authentication providers

Server Management

  • Create new game servers via web interface
  • Configure server resources and settings
  • Manage server files via SFTP or web interface
  • Monitor server performance and logs

🔒 Security Considerations

  • User Access: Managed through PufferPanel's user system
  • File Permissions: Servers run under restricted user accounts
  • Network: SFTP and web ports exposed, consider firewall rules
  • Updates: Keep PufferPanel updated for security patches

🎮 Supported Games

PufferPanel supports many game servers including:

  • Minecraft (Java & Bedrock)
  • Garry's Mod
  • Counter-Strike
  • Team Fortress 2
  • And many more via templates
  • Garry's Mod PropHunt Server: Managed through this panel
  • Nginx: Provides reverse proxy for web interface
  • System Users: Game servers run under dedicated users

📚 External Resources