Docka Agent

Lightweight agent running on managed servers for monitoring and management.

What it Does

  • Metrics Collection - CPU, memory, disk, network usage
  • Container Management - Start, stop, restart containers
  • Deployments - Handle app deployments and rollbacks
  • SSH Key Sync - Manage authorized keys
  • Real-time Commands - WebSocket connection for instant response
  • Health Checks - Monitor application health

Automatic Installation

When you provision a server through Docka, the agent is installed automatically.

Manual Installation (BYOS)

For Bring Your Own Server (BYOS), install the agent manually:

Quick Install

curl -fsSL https://docka.dev/install-agent.sh | sudo sh -s -- \
  --server-id YOUR_SERVER_ID \
  --token YOUR_AGENT_TOKEN

Manual Download

# Linux AMD64
wget https://docka.dev/releases/latest/docka-agent-linux-amd64.tar.gz
tar -xzf docka-agent-linux-amd64.tar.gz
sudo mv docka-agent-linux-amd64 /opt/docka/docka-agent
sudo chmod +x /opt/docka/docka-agent

sudo tee /etc/docka-agent.env > /dev/null <<'EOF'
DOCKA_SERVER_ID=YOUR_SERVER_ID
DOCKA_AGENT_TOKEN=YOUR_AGENT_TOKEN
DOCKA_SERVER_URL=wss://api.docka.dev/agent/ws
DOCKA_METRICS_PORT=9100
DOCKA_API_PORT=18080
DOCKA_API_BIND_ADDR=0.0.0.0
DOCKA_LOG_LEVEL=info
EOF

sudo systemctl enable --now docka-agent

Runtime Checks

docka-agent --help
docka-agent --version
curl -fsS http://127.0.0.1:9100/health
sudo journalctl -u docka-agent -f
sudo systemctl restart docka-agent

Supported Platforms

  • Linux AMD64 (x86_64)
  • Linux ARM64 (aarch64)

Security

  • Token is hashed (SHA-256) before storage
  • WebSocket connections use TLS encryption
  • Constant-time token comparison prevents timing attacks
← CLI Overview →