Skip to content
Woho Logo Woho

Install Woho Server

Requirements

Section titled “Requirements”
  • Linux x86-64 operating system (Ubuntu 20.04+, Debian 11+, RHEL 8+, or any modern distro)
  • 512 MB RAM minimum
  • Ports 8080 (admin web UI) and 9000 (client connections) accessible
  • curl pre-installed (available on most distributions)

Install

Section titled “Install”

  1. Download the server binary

    Terminal window
    curl -Lo /usr/local/bin/woho https://woho.cesbo.com/server-latest

  2. Set execute permission

    Terminal window
    chmod +x /usr/local/bin/woho

  3. Verify the installation

    Terminal window
    woho -version

systemd Service

Section titled “systemd Service”

  1. Create a dedicated system user

    Terminal window
    useradd --system --no-create-home --shell /usr/sbin/nologin woho

  2. Create the data directory

    Terminal window
    mkdir -p /var/lib/woho
    chown woho:woho /var/lib/woho

  3. Create the service file at /etc/systemd/system/woho-server.service

    [Unit]
    Description=woho Remote Support Server
    After=network-online.target
    Wants=network-online.target
    

    [Service]
    Type=simple
    User=woho
    Group=woho
    WorkingDirectory=/var/lib/woho
    ExecStart=/usr/local/bin/woho \
        -http 0.0.0.0:8080 \
        -tcp 0.0.0.0:9000 \
        -db /var/lib/woho/woho.db
    Restart=always
    RestartSec=5
    NoNewPrivileges=true
    ProtectSystem=strict
    ProtectHome=true
    ReadWritePaths=/var/lib/woho
    PrivateTmp=true
    

    [Install]
    WantedBy=multi-user.target

  4. Enable and start the service

    Terminal window
    systemctl daemon-reload
    systemctl enable woho-server
    systemctl start woho-server

  5. Check the service is running

    Terminal window
    systemctl status woho-server

Access the Admin Panel

Section titled “Access the Admin Panel”

Open http://your-server-ip:8080 in your browser.

Default credentials:

FieldValue
Usernameadmin
Passwordadmin

Building from Source

Section titled “Building from Source”

The web UI is embedded into the binary at compile time via //go:embed — no web/ directory or Node.js needed on the server.

Terminal window
git clone https://github.com/your-org/woho.git
cd woho
npm install
npm run build:prod
go build -o bin/woho-server ./cmd/server

Copy the binary to the server and follow the systemd setup above.

Updating

Section titled “Updating”

Stop the service, replace the binary, then start again. The database is preserved.

Terminal window
systemctl stop woho-server
curl -Lo /usr/local/bin/woho https://woho.cesbo.com/server-latest
chmod +x /usr/local/bin/woho
systemctl start woho-server