Since this page explains Docker-specific information, it is recommended to see Source installation as well if you need detailed information.
Here are two ways to install Autoware by docker:
- The first way is to start Autoware with
prebuilt image, this is a quick start, this way you can only run Autoware simulator and not develop Autoware, it is only suitable for beginners
- The second way is to start Autoware with
devel image, which supports developing and running Autoware using docker
Docker installation for quick start#
docker installation for quick start
Docker installation for development#
docker installation for development
Here are solutions for a few specific errors:
cuda error: forward compatibility was attempted on non supported hw#
When starting Docker with GPU support enabled for NVIDIA graphics, you may sometimes receive the following error:
docker: Error response from daemon: OCI runtime create failed: container_linux.go:349: starting container process caused "process_linux.go:449: container init caused \"process_linux.go:432: running prestart hook 0 caused \\\"error running hook: exit status 1, stdout: , stderr: nvidia-container-cli: initialization error: cuda error: forward compatibility was attempted on non supported hw\\\\n\\\"\"": unknown. ERROR: Command return non-zero exit code (see above): 125
This usually indicates that a new NVIDIA graphics driver has been installed (usually via
apt) but the system has not yet been restarted. A similar message may appear if the graphics driver is not available, for example because of resuming after suspend.
To fix this, restart your system after installing the new NVIDIA driver.
Docker with NVIDIA gpu fails to start Autoware on arm64 devices#
When starting Docker with GPU support enabled for NVIDIA graphics on arm64 devices, e.g. NVIDIA jetson AGX xavier, you may receive the following error:
nvidia@xavier:~$ rocker --nvidia --x11 --user --volume $HOME/autoware -- ghcr.io/autowarefoundation/autoware-universe:humble-latest-cuda-arm64 ... Collecting staticx==0.12.3 Downloading https://files.pythonhosted.org/packages/92/ff/d9960ea1f9db48d6044a24ee0f3d78d07bcaddf96eb0c0e8806f941fb7d3/staticx-0.12.3.tar.gz (68kB) Complete output from command python setup.py egg_info: Traceback (most recent call last): File "", line 1, in File "/tmp/pip-install-m_nm8mya/staticx/setup.py", line 4, in from wheel.bdist_wheel import bdist_wheel ModuleNotFoundError: No module named 'wheel' Command "python setup.py egg_info" failed with error code 1 in /tmp/pip-install-m_nm8mya/staticx/ ...
This error exists in current version of rocker tool, which relates to the os_detection function of rocker.
To fix this error, temporary modification of rocker source code is required, which is not recommended.
At current stage, it is recommended to run docker without NVIDIA gpu enabled for arm64 devices:
rocker -e LIBGL_ALWAYS_SOFTWARE=1 --x11 --user --volume $HOME/autoware -- ghcr.io/autowarefoundation/autoware-universe:latest-cuda
This tutorial will be updated after official fix from rocker.
Non-native arm64 System#
This section describes a process to run
arm64 systems on
amd64 systems using
Initially, your system is usually incompatible with
To check that:
$ docker run --rm -t arm64v8/ubuntu uname -m WARNING: The requested image's platform (linux/arm64/v8) does not match the detected host platform (linux/amd64) and no specific platform was requested standard_init_linux.go:228: exec user process caused: exec format error
qemu-user-static enables us to run
arm64 images on
$ sudo apt-get install qemu-user-static $ docker run --rm --privileged multiarch/qemu-user-static --reset -p yes $ docker run --rm -t arm64v8/ubuntu uname -m WARNING: The requested image's platform (linux/arm64/v8) does not match the detected host platform (linux/amd64) and no specific platform was requested aarch64
To run Autoware's Docker images of
arm64 architecture, add the suffix
$ docker run --rm -it ghcr.io/autowarefoundation/autoware-universe:humble-latest-cuda-arm64 WARNING: The requested image's platform (linux/arm64) does not match the detected host platform (linux/amd64) and no specific platform was requested root@5b71391ad50f:/autoware#