Files
homelab-optimized/hosts/vms/seattle/pufferpanel/README.md
Gitea Mirror Bot fb00a325d1
Some checks failed
Documentation / Build Docusaurus (push) Failing after 5m14s
Documentation / Deploy to GitHub Pages (push) Has been skipped
Sanitized mirror from private repository - 2026-04-18 11:19:59 UTC
2026-04-18 11:19:59 +00:00

108 lines
2.8 KiB
Markdown

# 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
```bash
# 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
```bash
# 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
## 🔗 Related Services
- **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
- [PufferPanel Documentation](https://docs.pufferpanel.com/)
- [GitHub Repository](https://github.com/PufferPanel/PufferPanel)
- [Community Discord](https://discord.gg/pufferpanel)