# IoT box SSH connection

:::{note}
SSH connections are only available for {doc}`IoT boxes <../iot_box>`, not the {doc}`Windows
virtual IoT <../windows_iot>`.
:::

:::{warning}
- This feature should **only** be used with trusted parties, as it provides administrative
  access to the IoT box, which can create security issues.
- Managing an SSH connection is **not** covered under the standard Odoo support scope. Visit
  the [Odoo Support](https://www.odoo.com/help) page for additional information about what is
  covered.
:::

To provide an {abbr}`SSH (secure shell protocol)` connection to an IoT box, you must generate a
password:

1. Access the IoT box's homepage by opening the IoT app and clicking the IP address displayed
   on the IoT box's card.

2. Click the {icon}`fa-cogs` ({guilabel}`cogs`) button at the top-right, then {guilabel}`Remote
   Debug`.

3. In the {guilabel}`Remote Debugging` popup that opens, click {guilabel}`Generate` and save the
   password securely. Once you close the popup, the password will no longer be available.

   ```{image} ssh_connect/ssh-generate-password.png
   :alt: The Remote Debugging password generation window.
   ```

4. Enter the {guilabel}`Authentication Token` provided by the user attempting to connect to the IoT
   box.

5. Click {guilabel}`Enable Remote Debugging`.

:::{seealso}
- {doc}`../iot_box`
- {doc}`../connect`
:::