v1.7.2 · Latest Release
Install / Upgrade & Documentation
Run this on your VPS as root and replace the token with your own token from panel:
Infrastructure — Getting Started
Install / Upgrade
1
Infrastructure
Select where your VPS is hosted or if you're using a custom server.
2
Environment
Pick your operating system. Supported versions are listed inside each card.
3
Deployment
Please sign up to generate your secure installation command.
Required Ports
The following ports must be open (Allow All / Inbound + Outbound) on your VPS firewall for VPBoost to work:
| Action | Protocol | Port Range | Purpose |
|---|---|---|---|
| Allow | TCP/UDP | 27000 – 29000 |
Game server ports, master server heartbeats & challenges, player traffic. |
| Allow | TCP | 8069 |
VPBoost Agent API. |
| Allow | TCP | 443 |
HTTPS API calls to counter-strike-boost.com. |
Important: The installer only opens TCP 8069. You must open the game port range yourself.
Configuration
Agent Env File
Main env file location:
/etc/agent/vpboost/vpboost-agent.env
All values from this file are loaded by systemd into the agent process. The Redirects binary inherits them when the agent starts it.
| Variable | Default | Used by | Purpose |
|---|---|---|---|
VPBOOST_REDIRECT_TICKET_MODE |
true |
Agent | Adds -ticket arg when launching redirects. |
VPBOOST_TICKET_DEBUG |
0 |
Redirects | Verbose ticket/auth debug logs. |
VPBOOST_A2S_DEBUG |
0 |
Redirects | Verbose A2S player/debug logs. |
VPBOOST_QUIET |
1 |
Redirects | Reduces console noise. |
VPBOOST_SCREEN_LOGS |
0 |
Agent | Enables screen session log files. |
Set Env With One Command
Example profile for debug mode + persistent screen logs:
cat <<'EOF' > /etc/agent/vpboost/vpboost-agent.env
VPBOOST_REDIRECT_TICKET_MODE=true
VPBOOST_TICKET_DEBUG=1
VPBOOST_A2S_DEBUG=1
VPBOOST_QUIET=0
VPBOOST_SCREEN_LOGS=1
EOF
systemctl daemon-reload
systemctl restart vpboost-agent
Reference
Live Logs / Crash Investigation
Most useful commands:
# service logs
journalctl -u vpboost-agent -f
# redirect screen logs (chunk mode)
tail -f /root/vpboost/screen_red-all-1.log
# list active screen sessions
screen -ls
If
screen_red-all-1.log does not appear, set VPBOOST_SCREEN_LOGS=1 and restart the service.
Config Source Flow
1
install.sh creates initial files and systemd service.
2
vpboost-agent.env is loaded by systemd on service start.
3
Agent reads env defaults from
config.go if var missing.
4
Agent starts Redirects; Redirects inherits env and reads
getenv().
5
Redirects fetches runtime data from API endpoints (
/api/getredirectconfig, /api/getports).Important Paths
/root/vpboost/vpboost
Agent binary
/root/vpboost/screen_red-all-1.log
Screen logs
/etc/agent/vpboost/vpboost-agent
Agent wrapper
/etc/agent/vpboost/vpboost-agent.env
Environment config
/etc/systemd/system/vpboost-agent.service
Systemd unit
Changelog
v1.7.2
Latest Release
April 10, 2026 20:47 UTC
Steam Ticket Mode fix and Save All improvements
- Fixed Save All to correctly save settings across all tabs (ports, servers, player stats, masterserver)
- Fixed Steam Ticket Mode (manual/auto) not persisting after save
- Tab persistence: page now stays on the active tab after saving
- Added CSB Manager download button in the Steam Ticket Mode section
- Single automatic restart after Save All instead of multiple restarts per component
Network Adoption
6
active VPS
v1.5.7
March 27, 2026 18:44 UTC
Masterserver protocol compatibility expansion
- Added multi-protocol heartbeat compatibility for CS 1.6/community masters (legacy, addserver, valve heartbeat2, q-only).
- Added per-target protocol prefixes in masters config and VPBOOST_MASTERS entries.
- Added VPBOOST_MASTER_PROTOCOL_DEFAULT for fleet-wide default heartbeat mode control.
- Improved challenge parsing and registration flow to handle more master implementations.
- Added compatibility heartbeat smoke test documentation for safer rollout.
Network Adoption
4
active VPS
v1.5.6
March 25, 2026 16:00 UTC
MasterServer heartbeat and performance improvements
- Added a new MasterServer heartbeat system for better listing consistency.
- Improved VPBoost performance and overall runtime stability.
- Refined panel workflows and admin visibility for smoother management.
- Included additional quality-of-life and reliability improvements.
Network Adoption
4
active VPS
v1.5.5
February 11, 2026 15:07 UTC
Redirect crash fix + full screen logs
- Fixed Redirects crash on invalid UTF-8 player names when building JSON payload for /api/newplayer.
- Added safe JSON serialization with UTF-8 replacement and exception guard (no hard terminate).
- Disabled 5-line join feed truncation/clear; console now prints full join log lines.
- Updated agent screen logging to append history and include START/EXIT markers with exit codes.
Network Adoption
7
active VPS









