Skip to main content
Use this page after the machine has already joined IDYL with idyl node join. For the first-time setup flow, start with Connect a node. These commands manage the local user service. They do not change fleet membership, subnet admission, or account ownership.

Start the service

Start an admitted node:
If admission is pending, idyl node start leaves the service stopped.

Check status

The status output includes the local node identity, realm, service state, and configured local resource limits. The provider display name is account-owned presentation metadata, not local node configuration. Use idyl node edit --set-display-name <name> or idyl node edit --clear-display-name to change it. A rename does not require a service restart.

View local config

Show the local node config paths, realm, and contribution limits:
Update the local node config:
You can also set disk and GPU limits:
If the service is running, stop and start it for updated limits to take effect.

View logs

Follow logs as the service runs:

Stop the service

Stopping the local service keeps the node identity and account registration. You can start the service again with idyl node start.

Remove the service integration

Use uninstall when you no longer want the user service installed on this machine:
This stops and removes the local service integration. It does not delete the node identity, unregister the node, or revoke admission.

Reset local node state

Reset deletes the local node identity and local node state:
Use reset only when you intentionally want this machine to stop using its current node identity. Reset does not transfer ownership to another account.