{"id":19175831,"url":"https://github.com/handcraftedbits/docker-nginx-unit-jira","last_synced_at":"2026-06-20T13:30:18.173Z","repository":{"id":95812315,"uuid":"63910286","full_name":"handcraftedbits/docker-nginx-unit-jira","owner":"handcraftedbits","description":"A Docker container that provides an Atlassian JIRA unit for NGINX Host","archived":false,"fork":false,"pushed_at":"2017-03-21T02:03:54.000Z","size":16,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-04T01:56:26.095Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/handcraftedbits.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-07-22T00:09:03.000Z","updated_at":"2016-07-22T00:10:53.000Z","dependencies_parsed_at":"2023-05-27T16:00:43.618Z","dependency_job_id":null,"html_url":"https://github.com/handcraftedbits/docker-nginx-unit-jira","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/handcraftedbits%2Fdocker-nginx-unit-jira","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/handcraftedbits%2Fdocker-nginx-unit-jira/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/handcraftedbits%2Fdocker-nginx-unit-jira/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/handcraftedbits%2Fdocker-nginx-unit-jira/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/handcraftedbits","download_url":"https://codeload.github.com/handcraftedbits/docker-nginx-unit-jira/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240254288,"owners_count":19772392,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T10:25:32.985Z","updated_at":"2026-06-20T13:30:18.122Z","avatar_url":"https://github.com/handcraftedbits.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NGINX Host JIRA Unit [![Docker Pulls](https://img.shields.io/docker/pulls/handcraftedbits/nginx-unit-jira.svg?maxAge=2592000)](https://hub.docker.com/r/handcraftedbits/nginx-unit-jira)\n\nA [Docker](https://www.docker.com) container that provides an\n[Atlassian JIRA](https://www.atlassian.com/software/jira) unit for\n[NGINX Host](https://github.com/handcraftedbits/docker-nginx-host).\n\n# Features\n\n* Atlassian JIRA 7.3.3\n* NGINX Host SSL certificates are automatically imported into JIRA's JVM so Atlassian application links can easily be \n  created\n\n# Support Notes\n\nThis container uses [OpenJDK](http://openjdk.java.net/) for its JVM and as such this unit is considered an **unsupported\nplatform** by Atlassian.\n\n# Usage\n\n## Prerequisites\n\n### Database\n\nMake sure you have a\n[supported database](https://confluence.atlassian.com/jira/connecting-jira-to-an-external-database-289276815.html)\navailable either as a container or standalone.\n\n### `NGINX_UNIT_HOSTS` Considerations\n\nIt is important that the value of your `NGINX_UNIT_HOSTS` environment variable is set to a single value and doesn't\ninclude wildcards or regular expressions as this value will be used by JIRA to determine the hostname.\n\n## Configuration\n\nIt is highly recommended that you use container orchestration software such as\n[Docker Compose](https://www.docker.com/products/docker-compose) when using this NGINX Host unit as several Docker\ncontainers are required for operation.  This guide will assume that you are using Docker Compose.  Additionally, we\nwill use the [official PostgreSQL Docker container](https://hub.docker.com/_/postgres/) for our database.\n\nTo begin, start with a basic `docker-compose.yml` file as described in the\n[NGINX Host configuration guide](https://github.com/handcraftedbits/docker-nginx-host#configuration).  Then, add a\nservice for the database (named `db-jira`) and the NGINX Host JIRA unit (named `jira`):\n\n```yaml\ndb-jira:\n  image: postgres\n  environment:\n    - POSTGRES_USER=user\n    - POSTGRES_PASSWORD=password\n    - POSTGRES_DB=jira\n  volumes:\n    /home/me/db-jira:/var/lib/postgresql/data\n\njira:\n  image: handcraftedbits/nginx-unit-jira\n  environment:\n    - NGINX_UNIT_HOSTS=mysite.com\n    - NGINX_URL_PREFIX=/jira\n  links:\n    - db-jira\n  volumes:\n    - data:/opt/container/shared\n    - /home/me/jira:/opt/data/jira\n```\n\nObserve the following:\n\n* We create a link in `jira` to `db-jira` in order to allow JIRA to connect to our database.\n* We mount `/opt/data/jira` using the local directory `/home/me/jira`.  This is the directory where JIRA stores its\n  data.\n* As with any other NGINX Host unit, we mount our data volume, in this case named `data`, to `/opt/container/shared`.\n\nFor more information on configuring the PostgreSQL container, consult its\n[documentation](https://hub.docker.com/_/postgres/).\n\nFinally, we need to create a link in our NGINX Host container to the `jira` container in order to proxy JIRA.  Here is\nour final `docker-compose.yml` file:\n\n```yaml\nversion: \"2.1\"\n\nvolumes:\n  data:\n\nservices:\n  db-jira:\n    image: postgres\n    environment:\n      - POSTGRES_USER=user\n      - POSTGRES_PASSWORD=password\n      - POSTGRES_DB=jira\n    volumes:\n      /home/me/db-jira:/var/lib/postgresql/data\n\n  jira:\n    image: handcraftedbits/nginx-unit-jira\n    environment:\n      - NGINX_UNIT_HOSTS=mysite.com\n      - NGINX_URL_PREFIX=/jira\n    links:\n      - db-jira\n    volumes:\n      - data:/opt/container/shared\n      - /home/me/jira:/opt/data/jira\n\n  proxy:\n    image: handcraftedbits/nginx-host\n    links:\n      - jira\n    ports:\n      - \"443:443\"\n    volumes:\n      - data:/opt/container/shared\n      - /etc/letsencrypt:/etc/letsencrypt\n      - /home/me/dhparam.pem:/etc/ssl/dhparam.pem\n```\n\nThis will result in making a JIRA instance available at `https://mysite.com/jira`.\n\n## Running the NGINX Host JIRA Unit\n\nAssuming you are using Docker Compose, simply run `docker-compose up` in the same directory as your\n`docker-compose.yml` file.  Otherwise, you will need to start each container with `docker run` or a suitable\nalternative, making sure to add the appropriate environment variables and volume references.\n\nWhen configuring JIRA, be sure to select `PostgreSQL` as your database, `db-jira` as the database hostname, and `5432`\nas the database port if you configured your database according to the previous section.\n\n# Reference\n\n## Environment Variables\n\nPlease see the NGINX Host [documentation](https://github.com/handcraftedbits/docker-nginx-host#units) for information\non the environment variables understood by this unit.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhandcraftedbits%2Fdocker-nginx-unit-jira","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhandcraftedbits%2Fdocker-nginx-unit-jira","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhandcraftedbits%2Fdocker-nginx-unit-jira/lists"}