Skip to main content
Version: Deploy 25.1

Run the Docker containers with Docker Compose

This topic guides you to run the Docker Containers with Docker Compose for Digital.ai Deploy.

Version-specific Docker images Digital.ai Deploy are published to Docker Hub:

Run the container using the docker-compose.yaml file

To start Digital.ai Deploy with a persistent setup:

  1. Download the Docker Compose file using the following command:

    curl https://raw.githubusercontent.com/xebialabs/xl-docker-images/master/docker-compose-example/docker-compose.yaml > docker-compose.yaml
  2. Open the docker-compose.yaml file and change the ADMIN_PASSWORD to a secure password.

  3. Run the file with Docker Compose:

    docker-compose up -d
  4. Access Deploy at http://localhost:4516/.

You can now remove the password from the docker-compose.yaml file.

You must provide a valid license before you can log in. Browse to the URL above and paste the license for Digital.ai Deploy. If you do not have a license yet, apply for a Deploy trial license on the Digital.ai website.

Set up Digital.ai Deploy using Docker Compose

If you want to use Digital.ai Deploy with Docker Compose, you can use the following example configuration. This allows you to start the container and move all command line options into a file.

  1. Create a file called docker-compose.yaml and copy the following contents inside:

    xld:
    image: xebialabs/xl-deploy:24.1.0
    container_name: xld
    ports:
    - "4516:4516"
  2. If you want to enable caching and configure an external cache server like Infinispan, add the following sections to the docker-compose.yaml file: Note: We have used Infinispan as the example for this section.

  • image: name of the Docker image of caching provider

  • networks: Name of the network that contains all container services.

  • ports: Port number for the caching server.

  • environment: User name and password for the caching server.

    infinispan: image: infinispan/server networks: xld-network ports: "11222:11222" environment: USER: admin PASS: admin Download the necessary JAR files and the cache provider property files and add this information to mount them on to the master and worker nodes:

    volumes:

    • $PWD/xl-deploy-server/conf/infinispan-hotrod.properties: /op/xebialabs/xl-deploy-server/conf/infinispan-hotrod.properties
    • $PWD/xl-deploy-server/conf/hotfix/lib: /op/xebialabs/xl-deploy-server/conf/hotfix/lib:z
  1. Start the container with this single command:


    docker-compose up -d
  2. The containers will start and the password can be viewed using these commands:

    docker logs xld
  3. You can configure the Digital.ai Deploy server under Settings > Shared Configuration. Use the following settings:

    image

note

You can run multiple Deploy containers by modifying the docker-compose.yaml file as needed.