> For the complete documentation index, see [llms.txt](https://docs.auterion.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.auterion.com/app-development/app-development/connecting-to-a-device.md).

# Connecting to a device

## Connect the device to your development machine

A [Skynode](https://docs.auterion.com/hardware-integration/skynode/skynode-ent-gov) will serve as an example throughout this chapter on how to connect and make use of some of the main Auterion CLI functionalities.

## Power up the device

Attach the device to its power supply module and thereafter insert the electrical plug inside a power socket. The device should automatically start. If any problem arises, refer to the "[Get Skynode ready](/hardware-integration/skynode/evaluation-kit/get-skynode-ready.md)" guide on how to appropriately power up Skynode.

Connect the device to your development computer using a USB cable.

<figure><img src="/files/UXiVpOAcKfHLXwX43Kwp" alt=""><figcaption></figcaption></figure>

## Discover connected devices

We are now ready to leverage the preparation work done up to this point and finally make use of the Auterion CLI tool. To discover the devices connected to your development machine, open a new terminal and execute the following command:

```bash
auterion-cli device discover
```

As a result you should be presented with a list of all the devices directly connected to your system as well as the devices connected to your local network.

```
$ auterion-cli device discover

Found devices
selected       serial  version    addresses
----------  ---------  ---------  -------------
            000007002  v2.7.7     {'10.41.1.1'}
```

{% hint style="info" %}
If you want to learn how to connect your Skynode to your local network, follow the "[Skynode - Wifi connection](/hardware-integration/skynode/advanced-configuration/configuration.md)" guide.
{% endhint %}

## Selecting a device

Selecting a device serves the purpose of targeting the following auterion-cli commands towards that precise device. When using commands to get information or to act on a specific device, those will be executed on the selected device.

{% hint style="warning" %}
In the case you have not selected any device, Auterion CLI will automatically choose and select the USB connected device, if available.
{% endhint %}

The command to select a device looks as follows:

```bash
auterion-cli device select <serial number>
```

If the selection was successful, the following response will be printed inside your terminal window:

```
$ auterion-cli device select 000007002

Selected device with ID 000007002 on address 10.41.1.1
```

If multiple devices are connected to your machine, it is possible to verify which, if any, device is selected by using the previously explained [`device discover`](#discover-devices) command:

```
$ auterion-cli device discover

Found devices
selected       serial  version    addresses
----------  ---------  ---------  -------------
*           000007002  v2.7.7     {'10.41.1.1'}
```

The selected device will be logically labeled with a `*` under the selected column.

## Show a list of installed apps on a selected device

In order to get a list of all installed Apps and their status on a selected device the following command can be used:

```bash
auterion-cli app list
```

The resulting list will be published on your terminal window as shown below:

{% code fullWidth="false" %}

```
$ auterion-cli app list

Name                   Version    Status    Enable    Services              Status    Enable
---------------------  ---------  --------  --------  --------------------  --------  --------
app-base-v0            v0         stopped   disabled  base-image            exited    exited
com.auterion.test-app  0.0.1      running   enabled   test-app              running   running
```

{% endcode %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://docs.auterion.com/app-development/app-development/connecting-to-a-device.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.
