JIRA is one of the best Agile issue tracking tools out there, but choosing the right Docker image to run it is tricky.

Docker Hub lists more than 1 000 JIRA Docker images. Fortunately only a few have considerable number of stars helping to narrow it down to two:

  1. cptactionhank/atlassian-jira-software
  2. blacklabelops/jira

When running JIRA behind HAProxy that terminates SSL, e.g. @LetsEncrypt, cptactionhank/atlassian-jira-software turned out to be painful. Since JIRA does a lot of AJAX, considerable number of XHR requests broke over SSL termination rendering this Atlassian JIRA Docker image unusable.

In comparison, blacklabelops/jira ran out of the box with the following Docker Compose configuration:

version: '2'
services:
  web:
    image: 'blacklabelops/jira:7.5.0'
    hostname: '<jira host>'
    restart: always
    ports:
      - '8080:8080'
    links:
      - db
    volumes:
      - ./jira:/var/atlassian/jira
    environment:
      JIRA_DATABASE_URL: 'mysql://<database user>@db/<database name>'
      JIRA_DB_PASSWORD: '<database password>'
      JIRA_PROXY_NAME: '<jira host>'
      JIRA_PROXY_PORT: '443'
      JIRA_PROXY_SCHEME: 'https'
      DOCKER_WAIT_HOST: 'db'
      DOCKER_WAIT_PORT: '3306'
    logging:
      driver: json-file
      options:
        max-size: 10m
  db:
    image: mariadb:10.1
    environment:
      MYSQL_DATABASE: '<database name>'
      MYSQL_USER: '<database user>'
      MYSQL_PASSWORD: '<database password>'
      MYSQL_ROOT_PASSWORD: '<database root password>'
    volumes:
      - ./data:/var/lib/mysql
    logging:
      driver: json-file
      options:
        max-size: 10m
    restart: always
    command: mysqld --character-set-server=utf8 --collation-server=utf8_bin