> ## Documentation Index
> Fetch the complete documentation index at: https://otoyinc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Register Your Node

> This guide walks you through registering your machine as a Node on Dispersed.

Once [**prerequisites**](/node-operators/prequisites) are installed, proceed to register your machine with the network.

Visit your Dispersed console to generate a secret and public key as these will be requested on first run and then saved in the registry for subsequent runs.

On all platforms you can provide them via env vars "**DISNET\_PUBKEY**" and "**DISNET\_SECRET**", commandline --pubkey and --secretkey or config file (dotfile)

* Windows: AppData\Roaming\Otoy\config
* \* Linux: \~/.Otoy/config
* \* MacOS: \~/.Otoy/config

```text theme={null}
PUBKEY=************
SECRET=************
```

<Note>
  Note: Starting from v1.8.1 the config location was updated. The folder name was changed from `~/.otoy` to `~/.Otoy` on Linux and macOS, and the config file (dotfile) was renamed from `zernet` to `config`.
</Note>

Precedence is commandline > env var > dotfile.

<Tabs>
  <Tab title="Linux">
    ### 1. Download disNet

    Download `disNet` from the [Dispersed Console](https://console.dispersed.com) or contact support for access.

    <Frame>
      <img src="https://mintcdn.com/otoyinc/fbWdny2oSmyz86RZ/images/image-26.png?fit=max&auto=format&n=fbWdny2oSmyz86RZ&q=85&s=d0ec86d057f4a150d55b46137bba42b1" alt="Image" width="1207" height="211" data-path="images/image-26.png" />
    </Frame>

    ### 2. Run Registration

    Navigate to the directory with the `disNet` client binary and register using your API Key:

    **2.1 Find and navigate to the `disNet` client binary:**

    ```bash theme={null}
    cd /path/to/folder/with/disNet
    ```

    **2.2 Register (first time only):**

    ```bash theme={null}
    ./disNet --register --pubkey pk_your_public_key --secretkey sk_your_secret_key
    ```

    Expected output:

    ```text theme={null}
    Registration successful. Node UUID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
    ```

    The new node should appear in the Dashboard page of the Dispersed Console. You can have multiple nodes.

    ### 3. Start the disNet client

    After registration, start the client normally:

    ```bash theme={null}
    ./disNet --pubkey pk_your_public_key --secretkey sk_your_secret_key
    ```

    <Note>
      You only need the `--register` flag on first run. After that, just use `--pubkey` and `--secretkey`.
    </Note>

    ...
  </Tab>

  <Tab title="Windows">
    ### 1. Download disNet

    Download `disNet` from the Dispersed Console or contact support for access.

    <Frame>
      <img src="https://mintcdn.com/otoyinc/fbWdny2oSmyz86RZ/images/image-27.png?fit=max&auto=format&n=fbWdny2oSmyz86RZ&q=85&s=28f86ae1e00bdc3461bdebaee51b9a0d" alt="Image" width="1207" height="211" data-path="images/image-27.png" />
    </Frame>

    ### 2. Run disNet

    Registration on windows is done automatically. Simply double click disNet.exe, on first run a dialog box will ask for your pubkey and secretkey, this will be saved and used in subsequent runs.

    <Frame>
      <img src="https://mintcdn.com/otoyinc/fbWdny2oSmyz86RZ/images/image-21.png?fit=max&auto=format&n=fbWdny2oSmyz86RZ&q=85&s=dafd7744850fce1b2946a5b81ed3b8e8" alt="Image" width="606" height="239" data-path="images/image-21.png" />
    </Frame>

    disNet can also be run from the commandline in the same way as the Linux version is, this is useful if you want to specify a quota.

    You should be able to see your node on the Dispersed Console > Dashboard

    <Frame>
      <img src="https://mintcdn.com/otoyinc/fbWdny2oSmyz86RZ/images/image-23.png?fit=max&auto=format&n=fbWdny2oSmyz86RZ&q=85&s=a770396fb269f92b03e6e182f265364f" alt="Image" width="1677" height="845" data-path="images/image-23.png" />
    </Frame>
  </Tab>
</Tabs>

***

## Troubleshooting

| Issue                         | Solution                                        |
| ----------------------------- | ----------------------------------------------- |
| `nvidia-smi` not found        | Install NVIDIA drivers                          |
| Docker permission denied      | Run with `sudo` or add user to `docker` group   |
| Container can't access GPU    | Verify `nvidia-container-toolkit` installation  |
| Node not appearing in Console | Check network connectivity and API key validity |

See [Troubleshooting](/troubleshooting) for more common issues.