# Launch container

The following examples launch an x86\_64 Ubuntu 22 image with a Python 3.10 environment, Apps SDK, and Platform SDK.

Run the container and map one or more QAic devices. Mapping one or more local directories with the `-v` option is highly recommended so you have a persistent workspace and don’t lose your work when the container stops.

# Passing 1 device
    docker run -dit --name qaic-ubuntu-test --device=/dev/accel/accel0 qaic-x86_64-ubuntu22-py310-py38-release-qaic_platform-qaic_apps:1.21.2.0
    
    # Passing 1 device and mapping a local folder
    docker run -dit --name qaic-ubuntu-test -v /data/test:/data/test --device=/dev/accel/accel0 qaic-x86_64-ubuntu22-py310-py38-release-qaic_platform-qaic_apps:1.21.2.0
    Copy to clipboard

## Architecture selection

When using the `-arch` option on a host whose architecture differs from the requested architecture, set up the host for Docker `multiarch` using QEMU.

Ubuntu host

sudo apt install qemu binfmt-support qemu-user-static
    docker run --rm --privileged multiarch/qemu-user-static --reset -p yes
    # Check the setup
    docker run --rm -t --platform=linux/arm64 <image name> uname -m
    Copy to clipboard

The command above should report the architecture as `aarch64`.

Last Published: Aug 25, 2026

[Previous Topic
Build a custom image](https://docs.qualcomm.com/bundle/publicresource/80-99100-3/topics/build-image.md) [Next Topic
Test container](https://docs.qualcomm.com/bundle/publicresource/80-99100-3/topics/test-container.md)