Skip to main content
Version: v2026.0.0

Docker Compose

This guide covers deploying ARender with Docker Compose, including the Classic viewer and all rendition backend services.

Services​

A full Classic deployment requires five containers:

ServiceImagePortPurpose
uiarender-ui-springboot8080Classic viewer UI
Document Service Brokerarender-document-service-broker8761REST API gateway and orchestration
Document Converterarender-document-converter19999Format conversion
Document Rendererarender-document-renderer-pdfowl9091Page rendering
Document Text Handlerarender-document-text-handler8899Text extraction

All images are available from artifactory.arondor.cloud:5001.

Prerequisites​

Log in to the ARender Docker registry before pulling images:

docker login artifactory.arondor.cloud:5001

Service discovery​

In Docker Compose, the broker discovers microservices via static configuration. Each microservice is configured with environment variables that set its hostname and port (using the legacy eureka.instance.* property namespace). The broker polls each service's health endpoint to track availability. No Eureka server is involved.

Full configuration​

docker-compose.yml
services:
  ui:
    image: artifactory.arondor.cloud:5001/arender-ui-springboot:2026.0.0
    ports:
      - 8080:8080
    environment:
      - "ARENDERSRV_ARENDER_SERVER_RENDITION_HOSTS=http://service-broker:8761/"

  service-broker:
    image: artifactory.arondor.cloud:5001/arender-document-service-broker:2026.0.0
    ports:
      - 8761:8761
    environment:
      - "DSB_KUBEPROVIDER_KUBE.HOSTS_DOCUMENT-CONVERTER=19999"
      - "DSB_KUBEPROVIDER_KUBE.HOSTS_DOCUMENT-RENDERER=9091"
      - "DSB_KUBEPROVIDER_KUBE.HOSTS_DOCUMENT-TEXT-HANDLER=8899"
    volumes:
      - arender-tmp:/arender/tmp

  document-converter:
    image: artifactory.arondor.cloud:5001/arender-document-converter:2026.0.0
    environment:
      - "DCV_EUREKA_INSTANCE_METADATA.MAP_HOST.NAME=document-converter"
      - "DCV_APP_EUREKA_HOSTNAME=service-broker"
      - "DCV_APP_EUREKA_PORT=8761"
    volumes:
      - arender-tmp:/arender/tmp

  document-renderer:
    image: artifactory.arondor.cloud:5001/arender-document-renderer-pdfowl:2026.0.0
    environment:
      - "DRN_EUREKA_INSTANCE_METADATA.MAP_HOST.NAME=document-renderer"
      - "DRN_EUREKA_INSTANCE_HOSTNAME=service-broker"
      - "DRN_EUREKA_SERVER_PORT=8761"
    volumes:
      - arender-tmp:/arender/tmp

  document-text-handler:
    image: artifactory.arondor.cloud:5001/arender-document-text-handler:2026.0.0
    environment:
      - "DTH_EUREKA_INSTANCE_METADATA.MAP_HOST.NAME=document-text-handler"
      - "DTH_EUREKA_INSTANCE_HOSTNAME=service-broker"
      - "DTH_EUREKA_SERVER_PORT=8761"
    volumes:
      - arender-tmp:/arender/tmp

volumes:
  arender-tmp:

The ui service runs the Classic viewer on port 8080. It connects to the service broker via ARENDERSRV_ARENDER_SERVER_RENDITION_HOSTS. The rendition backend services share a temporary volume for document processing.

Environment variable conventions​

All YAML configuration properties can be overridden via environment variables. Each service uses a dedicated prefix (ARENDERSRV_ for the viewer, DSB_, DCV_, DRN_, DTH_ for backend services). See Environment variables for the full naming convention with examples.

Shared volume​

The arender-tmp volume must be accessible by all backend services (broker, converter, renderer, text handler). Documents are stored on this volume during processing. See System architecture for details.

Next steps​

Last updated on