- Atlassian JIRA 7.3.3
- NGINX Host SSL certificates are automatically imported into JIRA's JVM so Atlassian application links can easily be
This container uses OpenJDK for its JVM and as such this unit is considered an unsupported
platform by Atlassian.
Make sure you have a
available either as a container or standalone.
It is important that the value of your
NGINX_UNIT_HOSTS environment variable is set to a single value and doesn't
include wildcards or regular expressions as this value will be used by JIRA to determine the hostname.
It is highly recommended that you use container orchestration software such as
Docker Compose when using this NGINX Host unit as several Docker
containers are required for operation. This guide will assume that you are using Docker Compose. Additionally, we
will use the official PostgreSQL Docker container for our database.
To begin, start with a basic
docker-compose.yml file as described in the
NGINX Host configuration guide. Then, add a
service for the database (named
db-jira) and the NGINX Host JIRA unit (named
db-jira: image: postgres environment: - POSTGRES_USER=user - POSTGRES_PASSWORD=password - POSTGRES_DB=jira volumes: /home/me/db-jira:/var/lib/postgresql/data jira: image: handcraftedbits/nginx-unit-jira environment: - NGINX_UNIT_HOSTS=mysite.com - NGINX_URL_PREFIX=/jira links: - db-jira volumes: - data:/opt/container/shared - /home/me/jira:/opt/data/jira
Observe the following:
- We create a link in
db-jirain order to allow JIRA to connect to our database.
- We mount
/opt/data/jirausing the local directory
/home/me/jira. This is the directory where JIRA stores its
- As with any other NGINX Host unit, we mount our data volume, in this case named
For more information on configuring the PostgreSQL container, consult its
Finally, we need to create a link in our NGINX Host container to the
jira container in order to proxy JIRA. Here is
version: "2.1" volumes: data: services: db-jira: image: postgres environment: - POSTGRES_USER=user - POSTGRES_PASSWORD=password - POSTGRES_DB=jira volumes: /home/me/db-jira:/var/lib/postgresql/data jira: image: handcraftedbits/nginx-unit-jira environment: - NGINX_UNIT_HOSTS=mysite.com - NGINX_URL_PREFIX=/jira links: - db-jira volumes: - data:/opt/container/shared - /home/me/jira:/opt/data/jira proxy: image: handcraftedbits/nginx-host links: - jira ports: - "443:443" volumes: - data:/opt/container/shared - /etc/letsencrypt:/etc/letsencrypt - /home/me/dhparam.pem:/etc/ssl/dhparam.pem
This will result in making a JIRA instance available at
Running the NGINX Host JIRA Unit
Assuming you are using Docker Compose, simply run
docker-compose up in the same directory as your
docker-compose.yml file. Otherwise, you will need to start each container with
docker run or a suitable
alternative, making sure to add the appropriate environment variables and volume references.
When configuring JIRA, be sure to select
PostgreSQL as your database,
db-jira as the database hostname, and
as the database port if you configured your database according to the previous section.
Please see the NGINX Host documentation for information
on the environment variables understood by this unit.