Title
Create new category
Edit page index title
Edit category
Edit link
lbcli list servers
List of servers resources.
xxxxxxxxxxlbcli list servers [flags]Examples:
xxxxxxxxxx# List all servers in yaml format:lbcli -J $JWT list servers --output-format=yaml| Flag | Short | Type | Default | Description | |
|---|---|---|---|---|---|
| --uuid | string | The UUID of the server. | |||
| --name | string | Server name. | |||
| --riskOfServiceLossState | string | “None” | Indicates if disabling a server will cause a service loss for some volume. | ||
| --help | -h | bool | Help for servers. |
This command returns the following fields for each server. The default output format is human-readable. The human-readable output only shows some of these fields. The json/yaml output format is also supported and includes additional fields.
The fields in bold below will be returned by the human-readable output.
| Field | Type | Description |
|---|---|---|
| Name | string | The server name. |
| ID | integer | Server ID. |
| Risk Of Service Loss State | string | Indicates if disabling a server will cause a service loss for some volume. |
| State | string | Enable/Disable status of the server. |
| LightOS Version | string | The current Lightbits version. |
| Upgrade Status | string | Upgrade status of the specific server (only in json/yaml format). |
| ApiEndpoints | list of strings | List of API endpoints exposed on this server (only in json/yaml format). |
| Server End Points | list of strings | List of server control endpoints URIs; i.e., http://192.168.80.14:2379 (only in json/yaml format) |
| Etag | String | For internal use (only in json/yaml format). |
| NodesUUIDs | list of strings | List of Lightbits nodes (identified by UUID) running over this server (only in json/yaml format). |
| LastUpgrade/Status | string | 3.3.1 and above Current status of the upgrade. The possible values are:
For a healthy upgrade flow, the upgrade should cycle through these statuses: None > Upgrading > Rebooting > Recovering > None |
| LastUpgrade/StartTime | timestamp | Start time of the upgrade on this server. |
| LastUpgrade/EndTime | timestamp | End time of the upgrade on this server. |
| LastUpgrade/TargetVersion | string | Lighbits version the server is being upgraded to. |
| LastUpgrade/ErrorMessage | string | Detailed error message if the upgrade operation failed. Note: ErrorMessage is limited to 40 characters, so in some cases long error messages will be concatenated. |
| LastUpgrade/ProgressStep | int | Progress of the upgrade operation. |
| LastUpgrade/ProgressTotal | int | The total steps in the upgrade operation. |
All upgrade information is structured into LastUpgrade. This will return either the information for a current ongoing upgrade, or if not, the upgrade in process will return information for the last upgrade that was run over this server.
© 2026 Lightbits Labs™