$$$$$$\ $$\ $$\ $$$$$$\ $$$$$$\ $$$$$$\ $$ __$$\ $$$\ $$$ |$$ __$$\ $$ __$$\ $$ __$$\ $$ / \__|$$$$\ $$$$ |$$ / $$ |$$ / \__|$$ / \__| \$$$$$$\ $$\$$\$$ $$ |$$$$$$$$ |$$ | $$ | \____$$\ $$ \$$$ $$ |$$ __$$ |$$ | $$ | $$\ $$ |$$ |\$ /$$ |$$ | $$ |$$ | $$\ $$ | $$\ \$$$$$$ |$$ | \_/ $$ |$$ | $$ |\$$$$$$ |\$$$$$$ | \______/ \__| \__|\__| \__| \______/ \______/ Author: Sven Loth (@slot) For: SMACC GmbH, www.smacc.io
Atlassian Jira Docker-Installation
This Repository contains a Dockerfile and scripts to run Atlassians Jira in a Docker container. It is based on smaccio/jre-base which contains a Oracle Java 8 JRE running on Ubuntu.
How to run it:
docker run -d -p 8080:8080 smaccio/jira
Jira needs a home directory in which custom data and important configuration is being stored. It also contains the database configuration file. It is wise to keep this directory seperated from the running Jira container, this makes it easier to upgrade Jira without having to copy data between containers.
The container is configured to expect the home folder in /srv/jira/home. Make sure you mount an external directory when starting the container to avoid data loss when upgrading. Use the -v option when running docker exec.
docker run -d -p 8080:8080 -v /path/to/jira/home:/srv/jira/home smaccio/jira
Ideally you'll create a data container first. A docker container that only provides a volume that conatins the home folder:
docker create --name jira-data -v /path/to/jira/home:/srv/jira/home smaccio/jira /bin/true
then run it with
docker run -d -p 8080:8080 --volumes-from jira-data smaccio/jira
Run Jira behind a SSL Proxy (e.g. apache2 or nginx)
If you run jira behind a proxy server that terminates ssl you want to set some special options in order for Jira to work smoothly. (see https://confluence.atlassian.com/adminjiraserver072/integrating-jira-with-apache-using-ssl-828788158.html)
- Proxy server name e.g. jira.smacc.io
- Proxy server port e.g. 443 (default, optional)
Start Jira with the following environment variables
docker run -d -p 8080:8080 -e SSL_PROXY_NAME=jira.smacc.io -e SSL_PROXY_PORT=443 smaccio/jira
Note: you may omit SSL_PROXY_PORT, it will default to port 443.
How to upgrade the Jira software:
- Pull from the repository
- Download the latest version as .tar.gz file from https://www.atlassian.com/software/jira/download
- untar the downloaded file in the source directory and rename the folder to "jira"
- edit jira/atlassian-jira/WEB-INF/classes/jira-application.properties
- set jira.home to /srv/jira/home
- save the file
- build the docker container
docker build -t smaccio/jira .
tag the new version, say it's 8.0:
docker tag smaccio/jira smaccio/jira:8.0
push to docker repository:
docker push smaccio/jira