openeuler/cannThe official CANN docker image.
Maintained by: openEuler CloudNative SIG.
Where to get help: openEuler CloudNative SIG, openEuler.
Current CANN docker images are built on the openEuler. This repository is free to use and exempted from per-user rate limits.
AI-oriented heterogeneous compute architecture provides hierarchical APIs to help you quickly build AI applications and services based on the Ascend platform.
Learn more about on CANN Document.
The tag of each cann docker image is consist of the complete software stack version. The details are as follows
| Tag | Currently | Architectures |
|---|---|---|
| 7.0.RC1.alpha002-oe2203sp2 | CANN 7.0.RC1.alpha002 on openEuler 22.03-LTS-SP2 | arm64 |
| 8.0.RC1-oe2203sp4 | CANN 8.0.RC1 with Python 3.8 on openEuler 22.03-LTS-SP4 | arm64,amd64 |
| 8.1.RC1-python3.11-oe2203lts | CANN 8.1.RC1 with Python 3.11 on openEuler 22.03-LTS | arm64,amd64 |
| 8.1.RC1-python3.11-oe2403lts | CANN 8.1.RC1 with Python 3.11 on openEuler 24.03-LTS | arm64,amd64 |
| 8.2.RC1.alpha001-python3.10-oe2203lts | CANN 8.2.RC1.alpha001 with Python 3.10 on openEuler 22.03-LTS | arm64,amd64 |
| 8.2.RC1.alpha002-python3.10-oe2203lts | CANN 8.2.RC1.alpha002 with Python 3.10 on openEuler 22.03-LTS | arm64,amd64 |
In this usage, users can select the corresponding {Tag} and container startup options based on their requirements.
Pull the openeuler/cann image from docker
bashdocker pull openeuler/cann:{Tag}
Start a cann instance
bashdocker run \ --name my-cann \ --device /dev/davinci1 \ --device /dev/davinci_manager \ --device /dev/devmm_svm \ --device /dev/hisi_hdc \ -v /usr/local/dcmi:/usr/local/dcmi \ -v /usr/local/bin/npu-smi:/usr/local/bin/npu-smi \ -v /usr/local/Ascend/driver/lib64/:/usr/local/Ascend/driver/lib64/ \ -v /usr/local/Ascend/driver/version.info:/usr/local/Ascend/driver/version.info \ -v /etc/ascend_install.info:/etc/ascend_install.info \ -it openeuler/cann:{Tag} bash
Container startup options
| Option | Description |
|---|---|
--name my-cann | Names the container my-cann. |
--device /dev/davinciX | NPU device, where X is the physical ID number of the chip, e.g., davinci1. |
--device /dev/davinci_manager | Davinci-related management device. |
--device /dev/devmm_svm | Memory management-related device. |
--device /dev/hisi_hdc | HDC-related management device. |
-v /usr/local/dcmi:/usr/local/dcmi | Mounts the host's DCMI .so and interface file directory /usr/local/dcmi to the container. Please modify according to actual situation. |
-v /usr/local/bin/npu-smi:/usr/local/bin/npu-smi | Mount the host npu-smi tool "/usr/local/bin/npu-smi" into the container. Please modify it according to the actual situation. |
-v /usr/local/Ascend/driver/lib64/:/usr/local/Ascend/driver/lib64/ | Mounts the host directory /usr/local/Ascend/driver/lib64/driver to the container. Please modify according to the path where the driver's .so files are located. |
-v /usr/local/Ascend/driver/version.info:/usr/local/Ascend/driver/version.info | Mounts the host's version information file /usr/local/Ascend/driver/version.info to the container. Please modify according to actual situation. |
-v /etc/ascend_install.info:/etc/ascend_install.info | Mounts the host's installation information file /etc/ascend_install.info to the container. |
-it | Starts the container in interactive mode with a terminal (bash). |
openeuler/cann:{Tag} | Specifies the Docker image to run, replace {Tag} with the specific version or tag of the openeuler/cann image you want to use. |
View container running logs
bashdocker logs -f my-cann
To get an interactive shell
bashdocker exec -it my-cann /bin/bash
If you have any questions or want to use some special features, please submit an issue or a pull request on openeuler-docker-images.


manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务