This is the first useful thing you can do in Luumen, and it takes about five minutes.
Before You Start
You need a server you can already reach over SSH (Linux or Unix) or WinRM (Windows), its address, and either a password, an SSH private key, or a key already in your local SSH agent. You will connect as the account that key or password belongs to, with that account's permissions.
Add Your First Host
Select Hosts in the left navigation. Choose Enter manually to add one host (you can also import a list of Hosts by choosing Upload inventory file).
In Add host details, enter the Hostname / IP. This is the only required field. You can include a port in the address, for example
web01.example.com:2222.Add a Display name if you want something friendlier than the address in your list. Left blank, the address is used.
Set the Connection type to SSH or WinRM. The Port fills in automatically, 22 for SSH and 5985 for WinRM.
Choose a Credential, or click Add credential to create one without leaving the form.
Click Test Connection. Luumen authenticates to the host with that credential and reports success or the exact error. Testing works for SSH only. A WinRM host is verified by connecting to it.
Click Add Host. A Host added confirmation tells you it is ready to connect.
Connect to a Host
Connect to the host from your list. Luumen opens a terminal session, and Co-Pilot opens alongside it already aware of the machine you are on. A badge above the composer reads Connected to your host and lists its public and private IP addresses and how many packages it found.
If the host has tmux 1.8 or later installed, your shell starts inside a tmux session named luumen- followed by an identifier, so work survives a dropped connection. If it does not, a notice says session persistence is unavailable on this host and the shell runs as an ordinary session.
Ask a LuumenAI a Question
Type into the box labeled Ask anything... You can ask questions like, "Why memory use is high?", "Which services failed to start since the last boot?", "What changed in the last package update?".
LuumenAI answers from the live state of that host rather than from general advice. When it wants to run something, it shows you the command and the host first and waits for Yes or No.
What to Try Next
Add the rest of your hosts. A credential you have saved can be attached to as many hosts as use that account.
Group your hosts once you have more than a handful, so you can connect to a tier or an environment at once.
Turn a runbook or SOP your team uses into a runable Skill.


