===================================
Connect an IoT Box to your database
===================================

Install the Internet of Things (IoT) App on your Odoo Database.

.. image:: media/connect01.png
   :align: center

Go in the IoT App and click on Connect on the IoT Boxes page.

.. image:: media/connect02.png
   :align: center

Follow the steps to connect your IoT Box.

.. image:: media/connect03.png
   :align: center

Ethernet Connection
~~~~~~~~~~~~~~~~~~~

1. Connect to the IoT Box all the devices that have to be connected with
   cables (ethernet, usb devices, etc.).

2. Power on the IoT Box.

3. Then click on the Scan button.

.. image:: media/connect04.png
   :align: center

WiFi Connection
~~~~~~~~~~~~~~~

1. Power on the IoT Box

2. Copy the token

.. image:: media/connect05.png
   :align: center

1. Connect to the IoT Box WiFi Network (make sure there is no ethernet
   cable plugged in your computer).

.. image:: media/connect06.png
   :align: center

4. You will be redirected to the IoT Box Homepage (if it doesn't work,
   connect to the IP address of the box). Give a name to your IoT Box (not
   required) and paste the token, then click on next.

.. image:: media/connect07.png
   :align: center

.. tip::
   If you are on Runbot, do not forget to add the -all or -base in the
   token (e.g. this token
   **http://375228-saas-11-5-iot-f3f920.runbot16.odoo.com\|4957098401**
   should become
   **http://375228-saas-11-5-iot-f3f920-all.runbot16.odoo.com\|4957098401**).

5. Choose the WiFi network you want to connect with (enter the password
   if there is one) and click on Submit. Wait a few seconds before being
   redirected to your database.

.. image:: media/connect08.png
   :align: center

You should now see the IoT Box.

.. image:: media/connect09.png
   :align: center

IoT Box Schema
~~~~~~~~~~~~~~

.. image:: media/connect10.png
   :align: center
