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

# Run the node service

> Manage the local IDYL node service after a node has joined.

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](/provide/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:

```bash theme={null}
idyl node start
```

If admission is pending, `idyl node start` leaves the service stopped.

## Check status

```bash theme={null}
idyl node 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:

```bash theme={null}
idyl node config show
```

Update the local node config:

```bash theme={null}
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:

```bash theme={null}
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

```bash theme={null}
idyl node logs
```

Follow logs as the service runs:

```bash theme={null}
idyl node logs --follow
```

## Stop the service

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
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.