> ## 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.

# Manage fleets

> Create provider fleets and connect nodes through fleet admission.

Use fleets when multiple provider nodes should be managed and admitted as a
group. A fleet belongs to an account. Nodes in that fleet must also belong to
the same account.

## 1. Create a fleet

```bash theme={null}
idyl fleet create --name "GPU Pool"
```

Output includes the fleet ID. Use that ID for the remaining commands.

## 2. List fleets

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

## 3. Show one fleet

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

## 4. Join a node through the fleet

Run this command on the machine that will provide capacity:

```bash theme={null}
idyl node join --fleet <fleet-id> --display-name gpu-1 --start
```

When `--fleet` is present, provider admission is evaluated through the fleet.
The command creates or loads the local node identity and proves ownership from
the machine before adding it to the fleet. The optional display name is
presentation metadata; fleet membership still uses the canonical node ID.

## 5. List fleet nodes

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

Output similar to:

```text theme={null}
DISPLAY NAME   NODE ID
gpu-1          63GtQFnlN3-lsHQBW6HlJZblsHPy8n5oYO1lG0qZQd4
```

The full node ID remains visible and is the value used by fleet, admission, and
placement commands. Display names can be duplicated and cannot be used as node
arguments.

## 6. Grant the fleet admission to a subnet

If you operate the subnet, grant provider admission to the fleet:

```bash theme={null}
idyl subnet admission grant --subnet <subnet> --provider-fleet <fleet-id>
```

Subnet operators can also grant admission to one specific node:

```bash theme={null}
idyl subnet admission grant --subnet <subnet> --provider-node <node-id>
```

Use direct node admission when one machine should be admitted without admitting
the whole fleet.

## 7. Remove a node from the fleet

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

Removing a node from a fleet changes future fleet-based admission decisions. It
does not delete the node identity from the machine.