Linux (Docker) Install

Run GenieX via Docker on Linux ARM64 with NPU access.

The Linux Docker path runs through a container image built for Linux ARM64 with NPU access (Dragonwing QCS9075 and similar IoT platforms).

This is the containerized path. If you’d rather install geniex directly on the host without Docker, see CLI Install → Linux ARM64 (Native).

Prerequisites

• Linux ARM64 host with Docker installed — if you don’t have Docker yet, follow Docker’s Ubuntu install guide.
• Dragonwing IoT chipset — see Supported platforms.
• Credentials with read access to one of the registries below.

Install host dependencies

The container reaches the NPU through the host’s Qualcomm driver libraries, mounted in via -v /usr/lib:/opt/qcom-lib:ro. Install them on the host before docker run — follow CLI Install → Install host dependencies.

Pull the image

The image is published to two registries — pick whichever you have access to and set IMAGE accordingly, then pull:

bash

# Option A — Docker Hub (public, no login required):
IMAGE=docker.io/qualcomm/geniex:latest

# Option B — Qualcomm Container Registry:
docker login docker-registry.qualcomm.com -u '$app' -p GB2S6KXMJXTPV8VHNFNS7Q6LVH75LOOBTLT8D723WUX6PSFZMTX95GIQG4EFWH5C021ONZ5763VI9IDHU96Q7VAZJ2830CLX3NPI6STQOJWRYXLLA2ZYTL1S
IMAGE=docker-registry.qualcomm.com/qcom-ai-hub/geniex-cli:latest

docker pull "$IMAGE"

If docker login fails or docker pull returns permission denied ... /var/run/docker.sock, see Troubleshooting → Linux for the credential and docker group fixes.

Run interactively

Drop into an interactive shell inside the container:

bash

docker run -it --rm --privileged \
  -v "$PWD/data:/data" \
  -v /usr/lib:/opt/qcom-lib:ro \
  "$IMAGE"

Verify

Then run a test command from the container shell:

bash

geniex --help

The --privileged flag is required for NPU access.

For server mode, see Local server.

CLI

For the full CLI Docker install guide, see CLI Install — Linux ARM64 (Docker).

Python

For the full Python install guide on native Linux ARM64, see Python Install — Linux ARM64.

The Python SDK can be installed inside the Docker container or directly on the Linux ARM64 host. See the Linux ARM64 tab for native install instructions.

Was this page helpful?

Yes

No