Join token and agent
Add a server with a one-time join token and a small agent. Only the control plane needs to be reachable: the docs examples use port 9443 for agents.
Use case: Homelab
Agents dial out to the Levelrail control plane over mutual TLS, so a server behind home NAT joins the same way a cloud VM does. Managed machines accept no inbound connections and store no SSH keys. Before you start, read the networking overview.
curl -fsSL https://levelrail.com/install.sh | sudo sh
How it works
What you get
Add a server with a one-time join token and a small agent. Only the control plane needs to be reachable: the docs examples use port 9443 for agents.
Placement is explicit. Cordon and drain move apps off a node when you need to take it down.
Docker events stream up from each agent, so the control plane never polls machines over SSH.
Metrics and logs stay on the node that produced them and are queried on demand, which keeps a small home server light.
Templates exist for media, home automation and file tools. Browse the template catalog.
In the product
Get started
Install the control plane on the machine that has a public address. The install guide covers it.
Create a join token and run the agent installer on each other machine.
Open the app's settings and choose the node it should run on.
levelrail-cli nodes join-token
levelrail-cli nodes list Run the agent with the token, then check that the node shows as online.
Go deeper
Scope and maturity, stated plainly so you can plan around them.
Maturity differs by feature. Feature status lists what is stable, beta or behind a flag, with the evidence for each.
FAQ
Yes, because the agent dials out and the server needs no inbound ports. The control plane itself needs a reachable address, and NAT traversal across a real WAN has not been tested yet.
Not yet: it is in beta, and a single node is the well-tested path. Run multi-node next to something you already trust until your own testing says otherwise. Architecture explains how the control plane and agents fit together.
One command installs the control plane. Apache 2.0, no license key and no paid tier.
curl -fsSL https://levelrail.com/install.sh | sudo sh