> For the complete documentation index, see [llms.txt](https://docs.degirum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.degirum.com/orca/usb.md).

# USB Setup

This page describes how to install and troubleshoot DeGirum Orca devices with a USB-C interface.

## Ubuntu Orca USB Setup

### Enable and Update DeGirum repository

{% stepper %}
{% step %}
Install prerequisites:

{% code overflow="wrap" %}

```bash
 sudo apt install curl
```

{% endcode %}
{% endstep %}

{% step %}
Download DeGirum public key:

For Ubuntu 20.04:

{% code overflow="wrap" %}

```bash
wget -O - -q http://assets.degirum.com/apt-repo/DeGirum.gpg.key | sudo apt-key add -
```

{% endcode %}

For Ubuntu 22.04 and Ubuntu 24.04:

{% code overflow="wrap" %}

```bash
curl -fsSL http://assets.degirum.com/apt-repo/DeGirum.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/degirum.gpg
```

{% endcode %}
{% endstep %}

{% step %}
Add the DeGirum software repository to your APT sources configuration file:

For Ubuntu 20.04:

{% code overflow="wrap" %}

```bash
echo deb [arch=amd64,arm64] https://assets.degirum.com/apt-repo ORCA main | sudo tee -a /etc/apt/sources.list
```

{% endcode %}

For Ubuntu 22.04:

{% code overflow="wrap" %}

```bash
echo deb [arch=amd64,arm64 signed-by=/usr/share/keyrings/degirum.gpg] https://assets.degirum.com/apt-repo ORCA main | sudo tee -a /etc/apt/sources.list
```

{% endcode %}

For Ubuntu 24.04:

{% code overflow="wrap" %}

```bash
echo 'Types: deb
URIs: https://assets.degirum.com/apt-repo
Suites: ORCA
Components: main
Architectures: amd64 arm64
Signed-By: /usr/share/keyrings/degirum.gpg' | sudo tee /etc/apt/sources.list.d/degirum.sources
```

{% endcode %}
{% endstep %}

{% step %}
Update package information from configured sources:

{% code overflow="wrap" %}

```bash
sudo apt update
```

{% endcode %}
{% endstep %}

{% step %}
Download and install DeGirum USB package:

{% code overflow="wrap" %}

```bash
sudo -E apt install dg-linusb
```

{% endcode %}
{% endstep %}
{% endstepper %}

### Troubleshooting

If the AI server does not operate properly, reinstall it using the steps in the [AI Server Configuration guide](https://docs.degirum.com/pysdk/user-guide-pysdk/setting-up-an-ai-server).

{% stepper %}
{% step %}
Verify that a `dg_orca` group exists and that the current user belongs to it:

{% code overflow="wrap" %}

```bash
cat /etc/group | grep dg_orca && groups | grep dg_orca
```

{% endcode %}

If the group does exist but the user is not in it, add the user via:

{% code overflow="wrap" %}

```bash
sudo -E usermod -a -G dg_orca <username>
```

{% endcode %}
{% endstep %}

{% step %}
If you installed DeGirum AI Server then verify AI Server operation:

{% code overflow="wrap" %}

```
degirum sys-info --host <hostname or IP>
```

{% endcode %}

Check for the `ORCA` section in the output. If it is missing, reinstall the server following [AI Server Configuration guide](https://docs.degirum.com/pysdk/user-guide-pysdk/setting-up-an-ai-server).
{% endstep %}
{% endstepper %}

## Windows Orca USB Setup

Hosts using DeGirum Orca with a USB-C interface need a driver to enable the device. The driver is distributed as a Zip archive.

{% stepper %}
{% step %}
Download the driver: [Orca Windows Driver](https://assets.degirum.com/usborca-amd64.zip)
{% endstep %}

{% step %}
Unpack the ORCA driver .zip file using Windows File Explorer.
{% endstep %}

{% step %}
Start Device Manager. Open the Power User menu by right-clicking on the Start button (or by pressing Win+X), then click "Device Manager".
{% endstep %}

{% step %}
Find "AI Accelerator device" under "Other devices".
{% endstep %}

{% step %}
Right-click on "AI Accelerator device", then select "Update driver".
{% endstep %}

{% step %}
Choose "Browse my computer for drivers".
{% endstep %}

{% step %}
Click "Browse…", then navigate to the folder that contains the driver files unpacked in Step 1. Check "Include subfolders". Then, click "Next".
{% endstep %}
{% endstepper %}