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

# devices

> Manage and interact with individual BIG-IP devices.

All `devices` commands accept a device **hostname or UUID**. crcli resolves hostnames automatically — no UUID hunting required.

## `devices list`

List all devices for your tenant.

```shell theme={null}
crcli devices list
```

**Flags:**

| Flag | Description |
| - | - |
| `-O, --output` | Output format: `table` (default), `json`, `yaml` |

## `devices get`

Show details for a single device.

```shell theme={null}
crcli devices get <device>
```

## `devices ssh`

Open an SSH session to a device.

```shell theme={null}
# Interactive terminal
crcli devices ssh <device>

# Run a single command
crcli devices ssh <device> -c "tmsh show sys version"

# Run a local script
crcli devices ssh <device> -S ./check_pools.sh

# Pipe a script via stdin
cat script.sh | crcli devices ssh <device>

# Multiple devices simultaneously
crcli devices ssh <device1> <device2> -c "uptime"
```

**Flags:**

| Flag | Short | Description |
| - | - | - |
| `--command` | `-c` | Run a command string on the device |
| `--script` | `-S` | Execute a local script file |
| `--interpreter` | `-i` | Interpreter for script execution (default: `bash`) |
| `--group` | `-g` | Buffer output per device instead of interleaving |
| `--output-dir` | | Save each device's output to a file in this directory |
| `--username` | `-u` | Log in with username/password instead of SSO |

## `devices web`

Open the BIG-IP TMUI web console in your browser, authenticated via SSO.

```shell theme={null}
crcli devices web <device>

# Print the URL instead of opening the browser
crcli devices web <device> -n
```

**Flags:**

| Flag | Short | Description |
| - | - | - |
| `--no-browser` | `-n` | Print the URL instead of opening the browser |
| `--username` | `-u` | Log in with username/password instead of SSO |

## `devices push`

Upload one or more files to a device.

```shell theme={null}
crcli devices push <device> ./file.conf
crcli devices push <device> ./file1.conf ./file2.conf

# Specify a remote destination path
crcli devices push <device> ./bigip.conf:/config/bigip.conf
```

## `devices pull`

Download one or more files from a device.

```shell theme={null}
crcli devices pull <device> /config/bigip.conf

# Save to a specific directory
crcli devices pull <device> /config/bigip.conf -o ./configs/

# Multiple files at once
crcli devices pull <device> /config/bigip.conf /config/bigip_base.conf -o ./configs/
```

**Flags:**

| Flag | Short | Description |
| - | - | - |
| `--output` | `-o` | Directory to save downloaded files (default: `.`) |

## `devices icontrol`

Create an authenticated iControl REST session and print the URL and token.

```shell theme={null}
crcli devices icontrol <device>
```

Paste the printed URL and token into your HTTP client or automation script.

## `devices backups`

List configuration backups for a device.

```shell theme={null}
crcli devices backups <device>
```

## `whoami`

Show your authenticated user details.

```shell theme={null}
crcli whoami
```

## Global Flags

All commands support these global flags:

| Flag | Short | Description |
| - | - | - |
| `--env` | `-e` | Environment: `prod` (default), `staging` |
| `--output` | `-O` | Output format: `table`, `json`, `yaml` |
| `--debug` | `-d` | Print HTTP request/response details |
| `--no-telemetry` | | Disable usage analytics |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.