> ## Documentation Index
> Fetch the complete documentation index at: https://sambanova-systems.mintlify.site/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

SambaRack Manager is a tool for centralized **hardware administration** of customer-managed, on-premises SambaRack deployments. SambaRack Manager enables operations at four levels:

* **Rack**: A complete SambaRack unit, including nodes and networking components.
* **Node**: An individual SN40L node unit within a Rack, excluding networking components.
* **Device**: Individual hardware components in a Rack.
* **Group**: A collection of Racks for batch operations.

See [What's in the Rack](/docs/en/v2.1.1/sambastack/resources/sn40l-16-hardware-reference#sambarack-sn40l-16-rack-components-2-pdu-configuration) for more details.

<Note>
  SambaRack Manager is **not** used for administering Kubernetes or SambaStack software.
</Note>

## Key capabilities

| Level       | Capabilities                                                                                                                                                                                                                                                           |
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Rack        | Add, remove, and view racks in the inventory. For individual racks, view, add, modify, or remove installed components and their details. Export rack definitions to JSON or YAML for sharing or backup, and import them to populate a new installation in one command. |
| Node        | View all nodes and node details. Rename nodes in the inventory.                                                                                                                                                                                                        |
| Power       | Perform DC power operations (power on, power off, power cycle, power state) on nodes, hosts, or XRDUs – for a single node or every node in a group.                                                                                                                    |
| Firmware    | Query installed firmware versions against the plan of record (POR) and push firmware upgrades to components – for a single rack or every rack in a group.                                                                                                              |
| Group       | Create, list, and delete groups. Add or remove racks from groups. Fan out power and firmware operations across all racks in a group.                                                                                                                                   |
| Credentials | Store device credentials in an encrypted local vault, one shared secret per device type.                                                                                                                                                                               |

## Typical workflow

1. **Install** the `snctl` binary – [Install and upgrade](srm-install)
2. **Initialize** configuration and verify dependencies – [Initial setup](srm-initial-setup)
3. **Add racks** and their devices to the inventory – import an inventory file in one command, or add them manually – [Rack administration](srm-rack-admin)
4. **Configure credentials** for every device type – [Device credentials](srm-device-credentials)
5. **Operate**: batch operations ([Group administration](srm-group-admin)), power ([Power Operations](srm-power-admin)), and firmware ([Firmware Updates](srm-firmware-updates))

New to SambaRack Manager? Work through the steps above in order, starting with [Install and upgrade](srm-install).
