Skip to content

Connect a Server

Connect your Dokku server to Wokku to start deploying apps.

Prerequisites

A VPS or dedicated server with Dokku installed
SSH access to the server
Your SSH private key

Add a Server

Go to Servers → Add Server
Enter a name for your server (e.g., “production”)
Enter the hostname or IP address
Set the SSH port (default: 22)
Paste your SSH private key
Click Connect

Wokku connects over SSH, verifies Dokku is installed, and syncs all existing apps and databases.

wokku servers:add production \
  --host dokku.example.com \
  --ssh-key ~/.ssh/id_ed25519

curl -X POST https://wokku.cloud/api/v1/servers \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "production",
    "hostname": "dokku.example.com",
    "ssh_port": 22,
    "ssh_private_key": "-----BEGIN OPENSSH PRIVATE KEY-----\n..."
  }'

Verify Connection

After connecting, Wokku automatically:

Tests the SSH connection
Detects the Dokku version
Syncs all existing apps, databases, and domains
Starts collecting health metrics (CPU, memory, disk)

You can check server status anytime:

Go to Servers and check the status indicator (green = healthy).

wokku servers

curl https://wokku.cloud/api/v1/servers/1/status \
  -H "Authorization: Bearer $TOKEN"

Next Steps