This page describes a possible way to use Nginx to proxy requests for JIRA running in a standard Tomcat container. You can find additional documentation that explains how to use Apache mod_proxy for the very same purpose.

Configuring Tomcat

In this example, we want a setup where JIRA can be accessed at the address (on standard HTTP port 80), while JIRA itself listens on port 8080 with context path /jira.

Set the Context Path

(info) If you want JIRA to serve on skip this section.

  1. Set your JIRA application path (the part after hostname and port). To do this in Tomcat (bundled with JIRA), edit <JIRA-INSTALL>/conf/server.xml, locate the “Context” definition:
  2. Change the path to the below:
  3. Restart JIRA and verify it can be accessed on the base URL (for example You may receive some errors about the dashboard being incorrectly configured – we’ll fix this in the next section.

Configure the Connector

  1. Configure the HTTP connectors so we have one serving as a proxy connector and another for troubleshooting. This is done in the same <JIRA-INSTALL>/conf/server.xml file, locate this code segment:
  2. And add the proxyName and proxyPort elements (replacing them with the appropriate properties), and another connector below – this is used for troubleshooting to bypass the proxy:

Configure Nginx

  1. Update the Nginx settings to have the below server (replacing with the FQDN and jira-hostname with the hostname of the server):

    (info) By default Nginx allows 1MB file to be attached into JIRA. So, parameter client_max_body_size is necessary to set the maximum size of attachment that can be uploaded into JIRA

  2. If configuring SSL, follow the instructions in to generate the profile.
  3. If you want to redirect HTTP to HTTPS the below can be used instead of the above block (remember to replace with the FQDN):
  4. If configuring SSL, ensure the security config from is used.
  5. Restart Nginx.


  1. Restart JIRA and verify it can be accessed on the base URL (for example and also the 8081 port (e.g.:
  2. For normal operation of JIRA you will also need to set the base URL accordingly. In this example the base URL shall be set to
  3. Disable GZIP compression as described in Configuring JIRA Options.


  • For the settings above to take effect you need to restart both JIRA and Nginx.
  • (warning) If you are facing loading problem with a page in JIRA, you will need to increase proxy_buffer_size to 8k. The default value for proxy_buffer_size is set to the page size of your system which on an x86/x86_64 is 4k.
  • (warning) If you encounter problems with input validation, it might be caused by the gzip compression enabled in reverse proxying. Such issue is described in the Creating a Confluence Gadget in JIRA Fails article.
  • If you encounter problems creating triggers when linked to Stash, please see the resolution described in the Unable to create Stash trigger in JIRA when using Nginx article.