Back to Documentation

Worker Installation

Install and configure the CapaCloud GPU worker on your machine

Quick Installation

The easiest way to install the GPU worker is using our one-command installer:

curl -s https://capa.cloud/install.sh | sudo bash

This script will automatically install all dependencies and set up the worker service.

What the Installer Does

Checks prerequisites: Verifies NVIDIA GPU and drivers

Installs Docker: Sets up Docker Engine if not already installed

Installs NVIDIA Container Toolkit: Enables GPU access in containers

Downloads worker script: Gets the latest worker software

Installs Python dependencies: Sets up required Python packages

Detects IP address: Automatically detects your machine's public IP

Configures service: Sets up systemd service for auto-start

Starts worker: Launches the worker service

Installation Requirements

Ubuntu 20.04+ or Windows 10 Pro+ with WSL2
NVIDIA GPU with CUDA support
NVIDIA drivers installed
Sudo/root access
Internet connection

Installation Process

Step 1: Run the Installer

curl -s https://capa.cloud/install.sh | sudo bash

Step 2: Enter Account ID

When prompted, enter your Account ID. You can find it:

Account Settings

View your Account ID

Register GPU Page

Also shows Account ID

Step 3: Verify IP Address Detection

The installer automatically detects your machine's public IP address. This will be used for SSH connections. Make sure it's correct and accessible from the internet.

Step 4: Verify Installation

After installation, verify the service is running:

sudo systemctl status capa-worker

Manual Installation

If you prefer to install manually or the automated installer doesn't work, see theTroubleshooting Guide for manual setup instructions.

Verifying Worker Registration

After installation:

  1. Go to Register GPU
  2. Your machine should appear in the "Pending Machines" list
  3. Complete registration to make it available for rent

Worker Management

Checking Status

sudo systemctl status capa-worker

Viewing Logs

sudo journalctl -u capa-worker -f

Restarting Worker

sudo systemctl restart capa-worker

Updating Worker

To update to the latest version:

curl -s https://capa.cloud/update.sh | sudo bash

Note: Update will only proceed if you have no active rentals.

Uninstalling Worker

To remove the worker:

curl -s https://capa.cloud/uninstall.sh | sudo bash

Note: Uninstall will only proceed if you have no active rentals.

SSH Key Management

Important: You don't need to provide SSH keys during registration. Consumers (renters) use their own SSH keys, which are automatically registered to your machine when they rent it. The worker handles all SSH key management automatically.

Troubleshooting

If you encounter issues during installation:

Check Troubleshooting Guide

Quick Checks:

  • • Verify NVIDIA drivers: nvidia-smi
  • • Check Docker: sudo systemctl status docker
  • • Review worker logs for errors