"The best software teams ship early and often - Not many tools, one tool. JIRA Software is built for every member of your software team to plan, track, and release great software." - [Source]
| Product | Version | Tags | Dockerfile | Size |
|---|---|---|---|---|
| Jira Software | 7.1.1 | 7.1.1, latest | Dockerfile |  |
| Jira Service Desk | 3.1.1 | servicedesk, servicedesk.3.1.0 | Dockerfile |  |
| Jira Core | 7.1.1 | core, core.7.1.1 | Dockerfile |  |
Older tags remain but are not supported/rebuild.
You may also like:
- blacklabelops/jira: The #1 software development tool used by agile teams
- blacklabelops/confluence: Create, organize, and discuss work with your team
- blacklabelops/bitbucket: Code, Manage, Collaborate
- blacklabelops/crowd: Identity management for web apps
Docker-Compose:
$ curl -O https://raw.githubusercontent.com/blacklabelops/jira/master/jirasoftware/docker-compose.yml
$ docker-compose up -d
Jira will be available at http://yourdockerhost
Docker-CLI:
$ docker run -d -p 80:8080 --name jira blacklabelops/jira
Jira will be available at http://yourdockerhost
- Start database server.
- Start Jira.
First start the database server:
Note: Change Password!
$ docker run --name postgres -d \
-e 'POSTGRES_USER=jira' \
-e 'POSTGRES_PASSWORD=jellyfish' \
-e 'POSTGRES_ENCODING=UNICODE' \
-e 'POSTGRES_COLLATE=C' \
-e 'POSTGRES_COLLATE_TYPE=C' \
blacklabelops/postgres
This is the blacklabelops postgres image.
Then start Jira:
$ docker run -d --name jira \
-e "JIRA_DATABASE_URL=postgresql://jira@postgres/jiradb" \
-e "JIRA_DB_PASSWORD=jellyfish" \
--link postgres:postgres \
-p 80:8080 blacklabelops/jira
Start the Jira and link it to the postgresql instance.
- Start a database server.
- Create a database with the correct collate.
- Start Jira.
Example with PostgreSQL:
First start the database server:
Note: Change Password!
$ docker run --name postgres -d \
-e 'POSTGRES_USER=jira' \
-e 'POSTGRES_PASSWORD=jellyfish' \
postgres:9.4
This is the official postgres image.
Then create the database with the correct collate:
$ docker run -it --rm \
--link postgres:postgres \
postgres:9.4 \
sh -c 'exec createdb -E UNICODE -l C -T template0 jiradb -h postgres -p 5432 -U jira'
Password is
jellyfish. Creates the databasejiradbunder userjirawith the correct encoding and collation.
Then start Jira:
$ docker run -d --name jira \
-e "JIRA_DATABASE_URL=postgresql://jira@postgres/jiradb" \
-e "JIRA_DB_PASSWORD=jellyfish" \
--link postgres:postgres \
-p 80:8080 blacklabelops/jira
Start the Jira and link it to the postgresql instance.
Note: It's not recommended to use a default initialized database for Jira in production! The default databases are all using a not recommended collation! Please use this for demo purposes only!
This is a demo "by foot" using the docker cli. In this example we setup an empty PostgreSQL container. Then we connect and configure the Jira accordingly. Afterwards the Jira container can always resume on the database.
Steps:
- Start Database container
- Start Jira
Let's take an PostgreSQL Docker Image and set it up:
Postgres Official Docker Image:
$ docker run --name postgres -d \
-e 'POSTGRES_DB=jiradb' \
-e 'POSTGRES_USER=jiradb' \
-e 'POSTGRES_PASSWORD=jellyfish' \
postgres:9.4
This is the official postgres image.
Postgres Community Docker Image:
$ docker run --name postgres -d \
-e 'DB_USER=jiradb' \
-e 'DB_PASS=jellyfish' \
-e 'DB_NAME=jiradb' \
sameersbn/postgresql:9.4-12
This is the sameersbn/postgresql docker container I tested.
Now start the Jira container and let it use the container. On first startup you have to configure your Jira yourself and fill it with a test license. Afterwards every time you connect to a database the Jira configuration will be skipped.
$ docker run -d --name jira \
-e "JIRA_DATABASE_URL=postgresql://jiradb@postgres/jiradb" \
-e "JIRA_DB_PASSWORD=jellyfish" \
--link postgres:postgres \
-p 80:8080 blacklabelops/jira
Start the Jira and link it to the postgresql instance.
Let's take an MySQL container and set it up:
MySQL Official Docker Image:
$ docker run -d --name mysql \
-e 'MYSQL_ROOT_PASSWORD=verybigsecretrootpassword' \
-e 'MYSQL_DATABASE=jiradb' \
-e 'MYSQL_USER=jiradb' \
-e 'MYSQL_PASSWORD=jellyfish' \
mysql:5.6
This is the mysql docker container I tested.
MySQL Community Docker Image:
$ docker run -d --name mysql \
-e 'ON_CREATE_DB=jiradb' \
-e 'MYSQL_USER=jiradb' \
-e 'MYSQL_PASS=jellyfish' \
tutum/mysql:5.6
This is the tutum/mysql docker container I tested.
Now start the Jira container and let it use the container. On first startup you have to configure your Jira yourself and fill it with a test license. Afterwards every time you connect to a database the Jira configuration will be skipped.
$ docker run -d --name jira \
-e "JIRA_DATABASE_URL=mysql://jiradb@mysql/jiradb" \
-e "JIRA_DB_PASSWORD=jellyfish" \
--link mysql:mysql \
-p 80:8080 \
blacklabelops/jira
Start the Jira and link it to the mysql instance.
You can specify your proxy host and proxy port with the environment variables JIRA_PROXY_NAME and JIRA_PROXY_PORT. The value will be set inside the Atlassian server.xml at startup!
When you use https then you also have to include the environment variable JIRA_PROXY_SCHEME.
Example HTTPS:
- Proxy Name: myhost.example.com
- Proxy Port: 443
- Poxy Protocol Scheme: https
Just type:
$ docker run -d --name jira \
-e "JIRA_PROXY_NAME=myhost.example.com" \
-e "JIRA_PROXY_PORT=443" \
-e "JIRA_PROXY_SCHEME=https" \
blacklabelops/jira
Will set the values inside the server.xml in /opt/jira/conf/server.xml
This is an example on running Atlassian Jira behind NGINX with 2 Docker commands!
First start Jira:
$ docker run -d --name jira \
-e "JIRA_PROXY_NAME=192.168.99.100" \
-e "JIRA_PROXY_PORT=80" \
-e "JIRA_PROXY_SCHEME=http" \
blacklabelops/jira
Example with dockertools
Then start NGINX:
$ docker run -d \
-p 80:8080 \
--name nginx \
--link jira:jira \
-e "SERVER1REVERSE_PROXY_LOCATION1=/" \
-e "SERVER1REVERSE_PROXY_PASS1=http://jira:8080" \
blacklabelops/nginx
Jira will be available at http://192.168.99.100.
This is an example on running Atlassian Jira behind NGINX-HTTPS with2 Docker commands!
Note: This is a self-signed certificate! Trusted certificates by letsencrypt are supported. Documentation can be found here: blacklabelops/nginx
First start Jira:
$ docker run -d --name jira \
-e "JIRA_PROXY_NAME=192.168.99.100" \
-e "JIRA_PROXY_PORT=443" \
-e "JIRA_PROXY_SCHEME=https" \
blacklabelops/jira
Example with dockertools
Then start NGINX:
$ docker run -d \
-p 443:44300 \
--name nginx \
--link jira:jira \
-e "SERVER1REVERSE_PROXY_LOCATION1=/" \
-e "SERVER1REVERSE_PROXY_PASS1=http://jira:8080" \
-e "SERVER1CERTIFICATE_DNAME=/CN=CrustyClown/OU=SpringfieldEntertainment/O=crusty.springfield.com/L=Springfield/C=US" \
-e "SERVER1HTTPS_ENABLED=true" \
-e "SERVER1HTTP_ENABLED=false" \
blacklabelops/nginx
Jira will be available at https://192.168.99.100.
First install:
Vagrant is fabulous tool for pulling and spinning up virtual machines like docker with containers. I can configure my development and test environment and simply pull it online. And so can you! Install Vagrant and Virtualbox and spin it up. Change into the project folder and build the project on the spot!
$ vagrant up
$ vagrant ssh
[vagrant@localhost ~]$ cd /vagrant
[vagrant@localhost ~]$ docker-compose up
Jira will be available on localhost:8080 on the host machine.
Leave a message and ask questions on Hipchat: blacklabelops/hipchat
This project is very grateful for code and examples from the repository: