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