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

# idyl fleet

> Manage provider fleets

View and manage provider fleets for the current account.

Fleets are provider capacity groups identified by a 12-digit Fleet ID.
The display name is a mutable label and is never used as an identifier.

## Usage

```bash theme={null}
idyl fleet
```

## Aliases

* `fleets`

## Commands

| Command                  | Description                        |
| ------------------------ | ---------------------------------- |
| `idyl fleet add-node`    | Add a node to a fleet              |
| `idyl fleet assign`      | Assign a fleet to a subnet         |
| `idyl fleet create`      | Create a fleet                     |
| `idyl fleet edit`        | Edit a fleet                       |
| `idyl fleet get`         | Get fleet details or list fleets   |
| `idyl fleet list-nodes`  | List fleet nodes                   |
| `idyl fleet remove-node` | Remove a node from a fleet         |
| `idyl fleet unassign`    | Remove a fleet's subnet assignment |

## Inherited flags

| Flag                                 | Description                                                        |
| ------------------------------------ | ------------------------------------------------------------------ |
| `-a <string>, --account-id <string>` | Account ID to use, overriding the current context.                 |
| `-c <string>, --context <string>`    | Use the named context for this command.                            |
| `--homedir <string>`                 | Override the configuration directory. Defaults to \~/.config/idyl. |
| `-n <string>, --namespace <string>`  | Namespace to use for this command.                                 |
| `-o <string>, --output <string>`     | Output format (json\|yaml).                                        |
| `-p <string>, --profile <string>`    | Override the access profile for this command.                      |
| `--realm <string>`                   | Override the realm for this command.                               |
| `--subnet <string>`                  | Override the context subnet for this command.                      |

## Examples

```bash theme={null}
idyl fleet list
idyl fleet get <fleet-id>
idyl fleet create --name "GPU Pool"
idyl fleet edit <fleet-id> --set-name "Lab Pool"
idyl fleet assign <fleet-id> --subnet <subnet>
idyl fleet add-node --fleet <fleet-id> --node <node-id>
```

## Subcommand reference

### `idyl fleet add-node`

Add a node to a provider fleet.

Provider fleet admission is enforced from these database rows. A node may
join a subnet through a fleet grant only when the node is an active member of
that fleet.

#### Usage

```bash theme={null}
idyl fleet add-node [flags]
```

#### Flags

| Flag                             | Description                                            |
| -------------------------------- | ------------------------------------------------------ |
| `--fleet <string>`               | Required. Fleet ID.                                    |
| `--node <string>`                | Required. Node ID.                                     |
| `-o <string>, --output <string>` | Output format: table, json, or yaml. Default: `table`. |

#### Examples

```bash theme={null}
idyl fleet add-node --fleet <fleet-id> --node <node-id>
```

### `idyl fleet assign`

Assign or reassign a fleet to one subnet.

Nodes that join under a fleet contribute capacity to the fleet's assigned
subnet. A fleet has at most one active assignment; assigning again replaces
the previous assignment.

#### Usage

```bash theme={null}
idyl fleet assign <fleet-id> [flags]
```

#### Flags

| Flag                             | Description                                            |
| -------------------------------- | ------------------------------------------------------ |
| `-o <string>, --output <string>` | Output format: table, json, or yaml. Default: `table`. |
| `--subnet <string>`              | Canonical subnet slug.                                 |

#### Examples

```bash theme={null}
idyl fleet assign <fleet-id> --subnet <subnet>
```

### `idyl fleet create`

Create a fleet

#### Usage

```bash theme={null}
idyl fleet create [flags]
```

#### Flags

| Flag                             | Description                                            |
| -------------------------------- | ------------------------------------------------------ |
| `--name <string>`                | Required. Fleet display name.                          |
| `-o <string>, --output <string>` | Output format: table, json, or yaml. Default: `table`. |

### `idyl fleet edit`

Edit a fleet

#### Usage

```bash theme={null}
idyl fleet edit <fleet-id> [flags]
```

#### Aliases

* `rename`

#### Flags

| Flag                             | Description                                            |
| -------------------------------- | ------------------------------------------------------ |
| `-o <string>, --output <string>` | Output format: table, json, or yaml. Default: `table`. |
| `--set-name <string>`            | Set the fleet display name.                            |

### `idyl fleet get`

Get fleet details or list fleets

#### Usage

```bash theme={null}
idyl fleet get [fleet-id] [flags]
```

#### Aliases

* `list`
* `ls`

#### Flags

| Flag                             | Description                                            |
| -------------------------------- | ------------------------------------------------------ |
| `-o <string>, --output <string>` | Output format: table, json, or yaml. Default: `table`. |

### `idyl fleet list-nodes`

List fleet nodes

#### Usage

```bash theme={null}
idyl fleet list-nodes [flags]
```

#### Aliases

* `ls-nodes`
* `get-nodes`

#### Flags

| Flag                             | Description                                            |
| -------------------------------- | ------------------------------------------------------ |
| `--fleet <string>`               | Required. Fleet ID.                                    |
| `-o <string>, --output <string>` | Output format: table, json, or yaml. Default: `table`. |

### `idyl fleet remove-node`

Remove a node from a fleet

#### Usage

```bash theme={null}
idyl fleet remove-node [flags]
```

#### Flags

| Flag               | Description         |
| ------------------ | ------------------- |
| `--fleet <string>` | Required. Fleet ID. |
| `--node <string>`  | Required. Node ID.  |

### `idyl fleet unassign`

Remove the fleet's active subnet assignment.

Nodes that join under the fleet stop being placeable on the subnet once the
assignment is removed.

#### Usage

```bash theme={null}
idyl fleet unassign <fleet-id> [flags]
```

#### Flags

| Flag                             | Description                                            |
| -------------------------------- | ------------------------------------------------------ |
| `-o <string>, --output <string>` | Output format: table, json, or yaml. Default: `table`. |

#### Examples

```bash theme={null}
idyl fleet unassign <fleet-id>
```