To run Atlassian Jira in Unit, follow these steps.


Command samples below assume you’re using Jira Core 7.13.0.

  1. Install Unit with Java support.

  2. Create an installation directory, adding a lib subdirectory to download third-party dependencies:

    $ cd /path/to/jira
    $ mkdir -p lib
    $ cd lib
    $ curl -O -C -
    $ curl -O -C -
    $ curl -O -C -
    $ curl -O -C -
    $ curl -O -C -
    $ curl -O -C -
    $ curl -O -C -
    $ curl -O -C -
    $ curl -O -C -
    $ curl -O -C - -L
  3. Download and extract Jira files:

    $ cd /path/to/jira
    $ tar xzf atlassian-jira-core-7.13.0.tar.gz
  4. Patch your Jira configuration, dropping env from the comp/env/UserTransaction object path. This ensures the UserTransaction object will be found by your installation:

    $ sed -i 's#comp/env/UserTransaction#comp/UserTransaction#g' \
  5. Prepare Unit configuration for your update. To obtain an initial template, query the control API:

    # curl --unix-socket /path/to/control.unit.sock \
           http://localhost/config/ > config.json


    Control socket path may vary; run unitd --help or see Startup for details.

    This creates a JSON file with Unit’s current settings. Add a listener in listeners and point it to your installation directory in applications. Also, add the following options and dependencies:

        "listeners": {
            "*:8080": {
                "pass": "applications/jira"
        "applications": {
            "jira": {
                "working_directory": "/path/to/jira/",
                "processes": 1,
                "type": "java",
                "webapp": "atlassian-jira-core-7.13.0-standalone/atlassian-jira",
                "options": [
                    "-Djavax.accessibility.assistive_technologies= ",
                "classpath": [

    See Java application options for details.


    You can’t update Jira configuration in Unit after application startup due to Jira’s own restrictions.

  6. Upload the updated configuration:

    # curl -X PUT --data-binary @config.json --unix-socket \
           /path/to/control.unit.sock http://localhost/config

    After a successful update, Jira should be available on the listener’s IP address and port. Navigate to Jira’s URI path (http://IP address:port/jira) to continue the setup in your browser:

    Jira in Unit - Setup Screen