# Setup

## Controller

{% hint style="danger" %}
In case of any manipulation with the controller, first turn off all power sources as there is a risk of electrocution or damage. Improper handling can result in significant property damage, bodily injury or death. Please refer to [Unipi Patron manual](https://kb.unipi.technology/_media/en:files:products:unipi-patron-manual-en.pdf) to read all safety instructions.&#x20;
{% endhint %}

### Connection using router

Connect the controller and luxonis camera to a router with running DHCP server (most routers have DHCP server on by default) and then connect the controller to a power supply as shown in the diagram below.

<div data-full-width="false"><figure><img src="https://599720499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTuTP9kHNw4UoUZQjsC6o%2Fuploads%2FJNaCVRGHSKWyshzyLoMg%2Fdiagram-switch.svg?alt=media&#x26;token=7f5f7eee-6a14-4a8d-b7c2-7f6edda7b80d" alt=""><figcaption></figcaption></figure></div>

### Direct connection

Connect the luxonis camera directly to the controller via USB and then connect the controller to your PC via ethernet as shown in the diagram below.

<div data-full-width="false"><figure><img src="https://599720499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTuTP9kHNw4UoUZQjsC6o%2Fuploads%2FoYiZksJW6TKFaX8sx3CW%2Fdiagram-usb.svg?alt=media&#x26;token=721841b4-aead-45bd-982e-da27dc0a7ee6" alt=""><figcaption></figcaption></figure></div>

### Accessing the controller

The easiest way to check if everything is running is to head over to `http://robopipe-<id>.local`, where *id* is the a number assigned to each controller on startup, based on the order in which you start the controllers, e.g. the first controller you connect will have id `1`, the next will have id `2` and so on. You should see output:&#x20;

```
Hello from Robopipe API!
```

The controller is also accesible via [SSH](https://en.wikipedia.org/wiki/Secure_Shell). The default hostname is set to `robopipe-<id>.local`. The default user is `admin` with password `robopipe.io`. Enter this command into your terminal to connect to the controller, enter `robopipe.io` when prompted for password:

```bash
ssh admin@robopipe-1.local
```

When connecting for the first time, you will be asked to verify the authenticity of the controller's key. Enter `yes` and press enter.

## Accepting the controller's certificate

In order to be able to use the [API Reference](https://robopipe.gitbook.io/doc/api/rest-api-reference) in full, you first need to accept the controller's self signed certificate. For each controller you have started, navigate to <https://robopipe-controller-\\><id>.local in your browser. You will be asked to accept security risks.

{% tabs %}
{% tab title="Chrome" %}
Click on "**Advanced**", then click "**Proceed to robopipe-controller-\<id>.local**".
{% endtab %}

{% tab title="Firefox" %}
Click on "**Advanced...**", then click on "**Accept the Risk and Continue**" (it takes a second for this button to become enabled).
{% endtab %}

{% tab title="Safari" %}
Click on "**Show Details**", then click on "**visit this website**" and lastly click on "**Visit Website**".
{% endtab %}
{% endtabs %}

{% embed url="<https://codepen.io/robopipe/pen/emOrpbX>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://robopipe.gitbook.io/doc/getting-started/connection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
