Documentation
Projects & VMs
Organize infrastructure by customer instead of a flat host list.
Projects
A project is the top-level organizational unit. In the typical agency or MSP model, it usually represents one customer.
Create a project with the + button at the start of the sidebar. Each project has:
- Name — shown in sidebar and at the top of monthly reports.
- Color — color dot on the left, helps recognize it at a glance even in a long list.
Rename or recolor anytime via the project’s context menu.
Deleting a project deletes its VMs too, along with their credentials and monitoring history. This action cannot be undone.
VMs
Each VM belongs to exactly one project and has these fields:
| Field | Meaning |
|---|---|
| Name | Display label. Should reflect role (web-01, db-primary) rather than IP. |
| Host | IP address or domain name for connection. |
| Port | SSH port, default 22. |
| Tag | Free-form labels for filtering and searching. |
| Last connected | Auto-updates each time you open a session. |
Using Tags Effectively
Tags only help with a convention. A few common sets:
- By environment:
prod,staging,dev - By role:
web,db,cache,mail - By priority:
critical,sla-24h
With command palette (Ctrl+K), type a tag to filter to that group of machines — faster than scrolling the sidebar.
Sidebar
The sidebar shows projects as a tree, expanding to lists of VMs. For each VM you can:
- Double-click — open terminal tab.
- Context menu — open SFTP, open monitoring tab, edit, manage credentials, delete.
The dot next to a VM’s name reflects the most recent monitoring poll, not SSH session status:
| Color | Meaning |
|---|---|
| Green | Latest poll succeeded. |
| Yellow | A threshold is being exceeded (disk, RAM, CPU). |
| Red | Two consecutive polls failed — VM considered unreachable. |
| Gray | Monitoring not enabled for this VM. |
Overview
The Overview screen rolls up all projects: how many VMs are monitored, how many unacknowledged alerts, and which machines have issues. This is the first place to look each morning — before opening any terminal.
Bulk Import
If you’re migrating from another tool, don’t type by hand. See Import from ~/.ssh/config: the app reads your existing OpenSSH config file and lets you checkbox the hosts to bring into a project.