TunnelFleet installs an agent on your VPS. The agent provisions VPN protocols, manages users, and reports status back to the dashboard.
Requirements
Use a fresh VPS when possible. TunnelFleet works best when it can configure Docker, firewall rules, and protocol containers without conflicting services on the same ports.
Install command
When you create a server, TunnelFleet shows a unique install command:
Run it over SSH as root:
Each install URL includes a one-time token for that server. Do not share it publicly. Generate a new server entry in the dashboard if the token is exposed.
What the installer does
- Registers the server with TunnelFleet
- Installs the TunnelFleet agent
- Pulls and starts protocol containers for your selection (WireGuard, OpenVPN TCP, OpenVPN UDP)
- Opens required firewall ports
- Creates the default VPN user
tunnelfleet
- Points a hostname at your server under
*.server.tunnelfleet.com
Provisioning phases
The dashboard tracks progress through:
- Waiting — waiting for the install script to start
- Preparing — agent and host dependencies
- Installing protocols — WireGuard / OpenVPN containers
- Configuring firewall — opening protocol ports
- Finalising — DNS and default user
When complete, the server status becomes ready and the agent shows as online.
Re-running or repairing
If a protocol fails or ports change:
- Open the server → Protocols
- Use Repair to re-run install, configure, firewall, and verify phases
You usually do not need to re-run the full host install script for protocol repairs.
After installation
- Confirm the agent is online on the server overview
- Open Users to manage VPN credentials
- Open Observe to stream protocol logs
- Download client configs and connect
Uninstall / remove
To stop managing a server from TunnelFleet:
- Archive — stops VPN containers but keeps DNS for faster restore
- Delete — permanently removes the server from TunnelFleet (including DNS cleanup)
Your VPS itself is not deleted. You retain SSH access and can clean up leftover packages manually if needed. 
