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 3 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.

If something fails, open Compute and Worker Node issues under Troubleshooting in the sidebar and server logs; Logs under Deployments and Operations in the sidebar.

Domains

Plan hostname and TLS strategy for Services you will expose; Domains and SSL under Deployments and Operations in the sidebar.

Next steps

Related