Install woho Client

The client is a lightweight agent that creates a single outbound TCP connection to your woho server — no inbound ports or firewall rules needed.

Prerequisites

Platform	Requirements
Linux	Kernel 3.10+, x86-64 or ARM64
Windows	Windows 7 SP1+ / Windows Server 2012+, x86-64

The client only needs outbound TCP access to your woho server on port 9000.

Linux

Download the client binary

curl -Lo /usr/local/bin/woho-client https://woho.cesbo.com/client-latest

Set execute permission
Terminal window
```
chmod +x /usr/local/bin/woho-client
```
Install as a system service

Replace your-server.com with your woho server address, and My-Server-01 with a descriptive name for this machine:
Terminal window
```
woho-client install -server your-server.com:9000 -name "My-Server-01"
```
If your server requires Pre-Shared Keys, add the -key flag:
Terminal window
```
woho-client install -server your-server.com:9000 -name "My-Server-01" -key XXXX-XXXX-XXXX
```

Start the service

systemctl start woho-client
systemctl enable woho-client

Check the service is running
Terminal window
```
systemctl status woho-client
```

The client appears in your admin panel within a few seconds of starting.

Service Management

# View real-time logs
journalctl -u woho-client -f

# Restart
systemctl restart woho-client

# Stop
systemctl stop woho-client

# Remove the service
woho-client uninstall

Windows

Run the following commands in an Administrator PowerShell session.

Download the client binary

Invoke-WebRequest -Uri "https://cdn.cesbo.com/woho/builds/woho-client-windows-amd64.exe" -OutFile "C:\Temp\woho-client.exe"

Install as a Windows service

C:\Temp\woho-client.exe install -server your-server.com:9000 -name "Windows-PC-01"

With a Pre-Shared Key:

C:\Temp\woho-client.exe install -server your-server.com:9000 -name "Windows-PC-01" -key XXXX-XXXX-XXXX

Start the service
Terminal window
```
sc.exe start woho-client
```
Verify it is running
Terminal window
```
sc.exe query woho-client
```

Service Management

# Stop service
sc.exe stop woho-client

# View in the Windows Services UI
services.msc

# Remove the service
.\woho-client.exe uninstall

See Client Configuration for UUID identity, reconnect behaviour, and all flags.

Updating

Stop the service, replace the binary, then start again:

# Linux
systemctl stop woho-client
curl -Lo /usr/local/bin/woho-client https://woho.cesbo.com/client-latest
chmod +x /usr/local/bin/woho-client
systemctl start woho-client

# Windows (Admin PowerShell)
sc.exe stop woho-client
Invoke-WebRequest -Uri "https://cdn.cesbo.com/woho/builds/woho-client-windows-amd64.exe" -OutFile "C:\Program Files\woho\woho-client.exe"
sc.exe start woho-client