> ## Documentation Index
> Fetch the complete documentation index at: https://geniex.aihub.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Linux (Docker) 安装
> 通过 Docker 在 Linux ARM64 上运行 GenieX，支持 NPU 访问。
Linux Docker 路径通过 Linux ARM64 容器镜像运行，并支持 NPU 访问（适用于跃龙 QCS9075 等 IoT 平台）。
### **前置条件**
* 安装了 Docker 的 Linux ARM64 主机——若尚未安装 Docker，请参照 [Docker 的 Ubuntu 安装指南](https://docs.docker.com/engine/install/ubuntu/)。
* 跃龙 IoT 芯片——详见[支持的平台](/cn/get-started/platforms)。
* 拥有以下任一镜像仓库读权限的凭据。
### **拉取镜像**
镜像同时发布到两个仓库——选择你有权限的一个，设置 `IMAGE` 后再拉取：
```bash bash theme={"dark"}
# Option A — Docker Hub (公开，无需登录):
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"
```
若 `docker login` 失败或 `docker pull` 返回 `permission denied ... /var/run/docker.sock`，参见[故障排查 → Linux](/cn/resources/troubleshooting#linux) 了解凭据与 `docker` 组的修复方法。
### **交互式运行**
进入容器内交互式 shell：
```bash bash theme={"dark"}
docker run -it --rm --privileged \
-v "$PWD/data:/data" \
-v /usr/lib:/opt/qcom-lib:ro \
"$IMAGE"
```
### **验证**
然后在容器 shell 中运行测试命令：
```bash bash theme={"dark"}
geniex --help
```
NPU 访问需要 `--privileged` 标志。
服务器模式参见[本地服务器](/cn/run/cli/local-server)。
## **CLI**
完整 CLI Docker 安装指南，参见 [CLI 安装 — Linux ARM64 (Docker)](/cn/run/cli/install)。
## **Python**
完整 Python 安装指南（原生 Linux ARM64），参见 [Python 安装 — Linux ARM64](/cn/run/python/install)。
Python SDK 既可安装在 Docker 容器内，也可直接安装在 Linux ARM64 主机上。原生安装指南请参见 [Linux ARM64 标签页](/cn/run/python/install)。