Files
odoo-docs/content/applications/general/iot/iot_advanced/ssh_connect.rst
Audrey (auva) 03a11048b6 [IMP] iot: 19.0 updates
task-5108135
2025-12-11 13:41:43 +01:00

35 lines
1.4 KiB
ReStructuredText

======================
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:
#. Open the IoT app, click the relevant IoT box's card, and click :guilabel:`Homepage`.
#. On the IoT system's homepage, click the :icon:`fa-cogs` (:guilabel:`cogs`) button at the
top-right, then :guilabel:`Remote Debug`.
#. 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.
#. Enter the :guilabel:`Authentication Token` provided by the user attempting to connect to the IoT
box.
#. Click :guilabel:`Enable Remote Debugging`.
.. seealso::
- :doc:`../iot_box`
- :doc:`../connect`