Skip to main content
add workers
After creating a managed cluster, you need to add where your applications will run. CNAP handles all the Kubernetes setup and once you connect your machines.
This guide applies to managed clusters only. For imported clusters, worker management is handled by your cloud provider or yourself, depending on your cluster type.
Testing locally? Use Multipass for free local testing before buying production servers. CNAP’s managed can communicate with local workers via tunneling without requiring public IP addresses.

​
Prerequisites

  • An active managed cluster (status shows “Active” in the dashboard)
  • A server or machine to connect (see supported operating systems below)
  • Server meets minimum requirements: 2 CPU, 4GB RAM (4 CPU, 8GB RAM recommended for production)

​
How to Add Workers

1

Get Worker Setup Command

In your clusters dashboard, click on your cluster and find the “Quick Actions” section. Click “Add a worker” and copy the bootstrap command.The command looks like:
Bootstrap command
curl -sSL https://workers.cnap.tech/join | sudo bash -s -- --token=your-cluster-token
Join token details: The token expires 30 minutes after generation and can be used multiple times to join multiple machines.
2

Connect and Run Setup Command

SSH into your server:
SSH to server
ssh root@your-server-ip
Then execute the bootstrap command you copied from the dashboard:
Run setup command
curl -sSL https://workers.cnap.tech/join | sudo bash -s -- --token=your-cluster-token
The script automatically installs Kubernetes components, joins the worker to your cluster, and configures networking and security.
3

Verify Connection

Your worker will appear in the dashboard within 1-2 minutes as “Active”. You can now start deploying applications to your cluster!

​
Supported Operating Systems

CNAP workers support a wide range of Linux distributions and Windows Server:
  • Debian: 11 (Bullseye), 12 (Bookworm)
  • Ubuntu: 22.04 LTS or later
  • Red Hat Enterprise Linux: 7.9, 8.10, 9.5
  • CentOS Stream: 9, 10
  • Oracle Linux Server: 8.9, 9.3
  • Amazon Linux: 2023
  • Fedora: 41 (Cloud Edition)
  • Fedora CoreOS: Stable stream
  • Alpine Linux: 3.19, 3.22
  • Flatcar Container Linux
  • Windows Server: 2019 (experimental support)

​
What’s Next?

Once workers are connected, you can:

Deploy Products Yourself

Trigger deploying your product from the dashboard to your own workspace

Package Your Software

Turn your applications into sellable products

Add More Capacity

Scale your infrastructure as demand grows

Learn About Clusters

Understand how clusters work in CNAP

​
Troubleshooting

  • Verify the server has internet connectivity
  • Check that the setup command was copied correctly
  • Ensure you’re running as root (with sudo)
  • Wait 2-3 minutes for the registration process
  • Check server meets minimum requirements (2 CPU, 4GB RAM)
  • Ensure you’re using a supported Linux distribution (see supported operating systems)
  • Verify no conflicting Docker/Kubernetes installations
  • Verify server has outbound networking access to the control plane (outbound HTTPS connections are allowed by default, but check if behind a firewall)
CNAP’s managed KaaS architecture is designed so workers don’t need public IP addresses. Workers automatically create outbound connectivity tunnels to the control plane, allowing the control plane to reach the kubelet securely. This works behind firewalls, NAT, and restrictive networks.