documentation/content/applications/general/iot/iot_advanced/ssh_connect.md
2025-02-27 18:56:07 +07:00

1.4 KiB

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

    :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 :::