{"id":34342025,"url":"https://github.com/ahaasler/docker-jira","last_synced_at":"2025-12-17T22:51:25.339Z","repository":{"id":25291987,"uuid":"28718064","full_name":"ahaasler/docker-jira","owner":"ahaasler","description":"A Docker image for Jira Core.","archived":false,"fork":false,"pushed_at":"2019-05-09T14:01:37.000Z","size":34,"stargazers_count":7,"open_issues_count":0,"forks_count":7,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-04-14T05:53:58.988Z","etag":null,"topics":["docker","jira"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/ahaasler/jira/","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/ahaasler.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}},"created_at":"2015-01-02T16:02:47.000Z","updated_at":"2021-08-22T23:34:58.000Z","dependencies_parsed_at":"2022-08-23T05:20:09.883Z","dependency_job_id":null,"html_url":"https://github.com/ahaasler/docker-jira","commit_stats":null,"previous_names":[],"tags_count":51,"template":false,"template_full_name":null,"purl":"pkg:github/ahaasler/docker-jira","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahaasler%2Fdocker-jira","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahaasler%2Fdocker-jira/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahaasler%2Fdocker-jira/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahaasler%2Fdocker-jira/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ahaasler","download_url":"https://codeload.github.com/ahaasler/docker-jira/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahaasler%2Fdocker-jira/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27787541,"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","status":"online","status_checked_at":"2025-12-17T02:00:08.291Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["docker","jira"],"created_at":"2025-12-17T22:51:24.778Z","updated_at":"2025-12-17T22:51:25.325Z","avatar_url":"https://github.com/ahaasler.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# docker-jira: A Docker image for Jira.\n\n[![Build status](https://travis-ci.org/ahaasler/docker-jira.svg?branch=master)](https://travis-ci.org/ahaasler/docker-jira)\n[![Docker Repository on Quay.io](https://quay.io/repository/ahaasler/jira/status \"Docker Repository on Quay.io\")](https://quay.io/repository/ahaasler/jira)\n[![Release](https://img.shields.io/github/release/ahaasler/docker-jira.svg?style=flat)](https://github.com/ahaasler/docker-jira/releases/latest)\n[![Docker Stars](https://img.shields.io/docker/stars/ahaasler/jira.svg?style=flat)](https://hub.docker.com/r/ahaasler/jira/)\n[![Docker Pulls](https://img.shields.io/docker/pulls/ahaasler/jira.svg?style=flat)](https://hub.docker.com/r/ahaasler/jira/)\n[![Image Size](https://images.microbadger.com/badges/image/ahaasler/jira.svg)](https://microbadger.com/images/ahaasler/jira)\n\n## Features\n\n* Runs on *Oracle Java* 8.\n* Ready to be configured with *Nginx* as a reverse proxy (https available).\n\n## Usage\n\n```bash\ndocker run -d -p 8080:8080 ahaasler/jira\n```\n\n### Parameters\n\nYou can use this parameters to configure your jira instance:\n\n* **-s:** Enables the connector security and sets `https` as connector scheme.\n* **-n \u0026lt;proxyName\u0026gt;:** Sets the connector proxy name.\n* **-p \u0026lt;proxyPort\u0026gt;:** Sets the connector proxy port.\n* **-c \u0026lt;contextPath\u0026gt;:** Sets the context path (do not write the initial /).\n\nThis parameters should be given to the entrypoint (passing them after the image):\n\n```bash\ndocker run -d -p 8080:8080 ahaasler/jira \u003cparameters\u003e\n```\n\n\u003e If you want to execute another command instead of launching jira you should overwrite the entrypoint with `--entrypoint \u003ccommand\u003e` (docker run parameter).\n\n### Nginx as reverse proxy\n\nLets say you have the following *nginx* configuration for jira:\n\n```\nserver {\n\tlisten                          80;\n\tserver_name                     example.com;\n\treturn                          301 https://$host$request_uri;\n}\nserver {\n\tlisten                          443;\n\tserver_name                     example.com;\n\n\tssl                             on;\n\tssl_certificate                 /path/to/certificate.crt;\n\tssl_certificate_key             /path/to/key.key;\n\tlocation /jira {\n\t\tproxy_set_header X-Forwarded-Host $host;\n\t\tproxy_set_header X-Forwarded-Server $host;\n\t\tproxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n\t\tproxy_pass http://127.0.0.1:8080;\n\t\tproxy_redirect off;\n\t}\n}\n```\n\n\u003e This is only an example, please secure you *nginx* better.\n\nFor that configuration you should run your jira container with:\n\n```bash\ndocker run -d -p 8080:8080 ahaasler/jira -s -n example.com -p 443 -c jira\n```\n\n### Persistent data\n\nThe jira home is set to `/data/jira`. If you want to persist your data you should use a data volume for `/data/jira`.\n\n#### Binding a host directory\n\n```bash\ndocker run -d -p 8080:8080 -v /home/user/jira-data:/data/jira ahaasler/jira\n```\n\nMake sure that the jira user (with id 547) has read/write/execute permissions.\n\nIf security is important follow the Atlassian recommendation:\n\n\u003e Ensure that only the user running Jira can access the Jira home directory, and that this user has read, write and execute permissions, by setting file system permissions appropriately for your operating system.\n\n#### Using a data-only container\n\n1. Create the data-only container and set proper permissions:\n\n\t* **Lazy way (preferred)** - Using [docker-jira-data](https://github.com/ahaasler/docker-jira-data \"A data-only container for docker-jira\"):\n\n\t\t```bash\ndocker run --name jira-data ahaasler/jira-data\n\t\t```\n\n\t* *I-wan't-to-know-what-I'm-doing* way:\n\n\t\t```bash\ndocker run --name jira-data -v /data/jira busybox true\ndocker run --rm -it --volumes-from jira-data debian bash\n\t\t```\n\n\t\tThe last command will open a *debian* container. Execute this inside that container:\n\n\t\t```bash\nchown 547:root /data/jira; chmod 770 /data/jira; exit;\n\t\t```\n\n2. Use it in the jira container:\n\n\t```bash\ndocker run --name jira --volumes-from jira-data -d -p 8080:8080 ahaasler/jira\n\t```\n\n### PostgreSQL external database\n\nA great way to connect your Jira instance with a PostgreSQL database is\nusing the [docker-jira-postgres](https://github.com/ahaasler/docker-jira-postgres \"A PostgreSQL container for docker-jira\")\nimage.\n\n1. Create and name the database container:\n\n\t```bash\ndocker run --name jira-postgres -d ahaasler/jira-postgres\n\t```\n\n2. Use it in the Jira container:\n\n\t```bash\ndocker run --name jira --link jira-postgres:jira-postgres -d -p 8080:8080 ahaasler/jira\n\t```\n\n3. Connect your Jira instance following the Atlassian documentation:\n[Configure your JIRA server to connect to your PostgreSQL database](https://confluence.atlassian.com/display/JIRA/Connecting+JIRA+to+PostgreSQL#ConnectingJIRAtoPostgreSQL-3.ConfigureyourJIRAservertoconnecttoyourPostgreSQLdatabase \"Configure your JIRA server to connect to your PostgreSQL database\").\n\n\u003e  See [docker-jira-postgres](https://github.com/ahaasler/docker-jira-postgres \"A PostgreSQL container for docker-jira\")\nfor more information and configuration options.\n\n## Thanks\n\n* [Docker](https://www.docker.com/ \"Docker\") for this amazing container engine.\n* [PostgreSQL](http://www.postgresql.org/) for this advanced database.\n* [Atlassian](https://www.atlassian.com/ \"Atlassian\") for making great products. Also for their work on [atlassian-docker](https://bitbucket.org/atlassianlabs/atlassian-docker \"atlassian-docker repo\") which inspired this.\n* And specially to you and the entire community.\n\n## License\n\nThis image is licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for the full license text.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahaasler%2Fdocker-jira","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fahaasler%2Fdocker-jira","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahaasler%2Fdocker-jira/lists"}