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:
idyl node start
If admission is pending, idyl node start leaves the service stopped.

Check status

idyl node status
The status output includes the local node identity, realm, service state, and configured local resource limits.

View local config

Show the local node config paths, realm, and contribution limits:
idyl node config show
Update the local node config:
idyl node config set --realm global.idyl.network
idyl node config set --limit-cpu 2 --limit-memory 1Gi
You can also set disk and GPU limits:
idyl node config set --limit-disk 50Gi --limit-gpu nvidia:1
If the service is running, stop and start it for updated limits to take effect.

View logs

idyl node logs
Follow logs as the service runs:
idyl node logs --follow

Stop the service

idyl node stop
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:
idyl node uninstall-service
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:
idyl node reset --dangerous
Use reset only when you intentionally want this machine to stop using its current node identity. Reset does not transfer ownership to another account.