---
title: "Using the images with Docker Compose"
slug: "oas-igdock-using-the-images-with-docker-compose-3-28"
updated: 2025-07-04T10:04:23Z
published: 2025-07-07T13:49:52Z
canonical: "docs.onespan.com/oas-igdock-using-the-images-with-docker-compose-3-28"
---

> ## 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-28)) 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. Import the image bundle archive into the local Docker registry:

```shell
docker load ‑i images.tar
```
2. Change to the example deployment folder:

```shell
cd <package_folder>/examples/docker-compose
```

Replace the following:
  - package_folder. The absolute path to the folder that contains the extracted package content.
3. 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-28)):

```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:<release_version>
```

Replace the following:
  - release_version. The specific version of the images distributed in the package, e.g. 3.27.0.1234.
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. Run the images:

```shell
docker compose up ‑d
```

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 <service_name>
docker compose up ‑d <service_name>
```

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, e.g. ias.