Skip to main content
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

idyl fleet create --name "GPU Pool"
Output includes the fleet ID. Use that ID for the remaining commands.

​
2. List fleets

idyl fleet list

​
3. Show one fleet

idyl fleet get <fleet-id>

​
4. Join a node through the fleet

Run this command on the machine that will provide capacity: 
idyl node join --fleet <fleet-id> --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.

​
5. List fleet nodes

idyl fleet list-nodes --fleet <fleet-id>

​
6. Grant the fleet admission to a subnet

If you operate the subnet, grant provider admission to the fleet: 
idyl subnet admission grant --subnet <subnet> --provider-fleet <fleet-id>
Subnet operators can also grant admission to one specific node: 
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

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.