--- title: "Using the images with Docker Compose" slug: "oas-igdock-using-the-images-with-docker-compose-3-29" updated: 2026-02-05T11:43:12Z published: 2026-02-05T11:43:12Z canonical: "docs.onespan.com/oas-igdock-using-the-images-with-docker-compose-3-29" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.onespan.com/llms.txt > Use this file to discover all available pages before exploring further. # Using the images with Docker Compose You can use the example contained in the package (see [Package overview](/sec/docs/oas-igdock-package-overview-3-29)) to set up a deployment using Docker Compose. The example files are for evaluation purposes only. They are a good starting point for your own deployment, but should not be used in productive environments "as is" without proper configuration. In particular, you need to do the following: - Update the pre-installed certificates. - Change the pre-defined credentials. To run the images with Docker Compose 1. If required, extract the package archive: ```shell tar -zxvf docker-.tar.gz ``` Replace the following: This extracts the package content to a release_version folder, for example, 3.29.0.1234. - release_version. The specific version of the package archive, for example, 3.29.0.1234. 2. Import the image bundle archive into the local Docker registry: ```shell docker load ‑i images.tar ``` 3. Change to the example deployment folder: ```shell cd /examples/docker-compose ``` Replace the following: - package_folder. The absolute path to the folder that contains the extracted package content. 4. Review and adapt the deployment configuration file, i.e. docker-compose.yml. In particular, note the following: - OneSpan Authentication Server and MDC log files are stored in the ./logs folder. - The database files are stored in the ./db folder. 5. Allow write access for the containers to the db and logs folders: ```shell chmod ‑R 777 db logs ``` 6. Review and adapt the configuration for OneSpan Authentication Server and Message Delivery Component (MDC) using the GUI configuration image (see [Using the GUI configuration image](/sec/docs/oas-igdock-using-the-gui-configuration-image-3-29)): ```shell sudo xhost +local:docker docker run --rm --user $(id -u) \           -v $(pwd)/config:/mnt \           -e DISPLAY=$DISPLAY \           -v /tmp/.X11-unix/:/tmp/.X11-unix/ \           onespan_config: ``` Replace the following: - release_version. The specific version of the images distributed in the package, for example, 3.29.0.1234. 7. Run the images: ```shell docker compose up ‑d ``` > Safe container start > > You can add the --wait option to block the command-line interface and wait until all containers are running and ready for requests (healthy): > > ```shell > docker compose up -d --wait > ``` To stop running containers - Run the following command: ```shell docker compose down ``` To restart running containers - To restart a locally running service, delete the container and re-create it. Run the following commands: ```shell docker compose down docker compose up ‑d ``` Replace the following: Restarting the containers with docker compose restart or docker restart is currently unsupported. - service_name. The name of a service as it is defined in the services section of the used deployment configuration file, for example, ias.