Add a self-hosted server

Connect a Linux server as a Worker Node: SSH keys, wizard, Dokku prep, and verification.

Written By Zoro

Last updated 9 days ago

The product may label this flow Add server; in documentation we call the result a Worker Node: infrastructure attached to Environments to run Services.

Before you start

  1. Create or import SSH keys dFlow will use; SSH keys under Security and Team Management in the sidebar.

  2. Have root or sudo access and the server IP or hostname.

  3. Open firewall rules for SSH (and later HTTP/S as required by your deploy model).

Run the wizard

  1. Click Add server / Add Worker Node in the dashboard.

  2. Enter host, SSH user, key or credential method, and optional labels.

  3. Test connection and fix SSH or network issues until the check passes.

  4. Save. The node should appear in your server or compute list.

First-time preparation

The dashboard may queue jobs to install Dokku, Git, monitoring, or other components. Let those finish before expecting app Deployments to succeed.

Next steps