We use the ADP project on IOHK Jira.

The Jira server used to be self-hosted by our IT department, it’s now hosted on the Atlassian Cloud.

Make sure that you don’t accidentally use the old URL which is jira.iohk.io.

Run through the Orientation Checklist to make sure that you know enough of the basics to use Jira effectively.


Here is a link to the Adrestia Sprint Board.

Account setup

Authentication to jira is done through SSO with your @iohk.io Google Account.

No anonymous access to Jira

Be aware that there is no anonymous access to IOHK Jira, so the general public will not be aware of the contents of tickets, nor can they open Jira tickets.

This is good in one sense because the information in bug trackers is raw and unfiltered, and sometimes doesn’t provide a complete picture of the issue. But on the other hand, the community can’t see information about bugs that might affect them, or planned features.

With this in mind, please provide enough extra information in your GitHub pull requests and commit messages so that the issue can be understood, without referring to Jira.


Developers are strongly recommended to use the go-jira CLI for querying Jira. It is faster to use than the web interface for searching, and can be scripted to fit our needs.

Advanced Search Syntax

Use advanced search if necessary.

There is some documentation about the syntax.

Jira Markup Syntax

Jira uses its own unique markup syntax for comments and text fields.

Use the little buttons beneath the text field to switch between visual and text mode.

The main things you will want are:


h3. My heading


Surround inline code with {{ and }}, e.g. {{monospaced}}.

Or make blocks with:

module Main where

main :: IO ()
main = putStrLn "Hello, Haskell!"

Link to URLs with [Atlassian|http://atlassian.com] and ping users with [~username].


Pandoc has a file format filter for Jira markup.

$ pandoc --from=commonmark_x --to=jira [--output=FILE] [FILES]

Orientation Checklist

  • Ensure that you can log in to your IOHK Jira account.
  • Orient youself with the following views:
  • Make sure you can do the following things in Jira:
    • Backlog view

      • Switch sprint
      • View all Versions, toggle Versions.
      • View all Epics, toggle Epics
      • Toggle Quick Filters, remove all filters.
    • Swimlanes

      • Change sprint view
      • See your assigned tasks
    • Issues list

      • Run an advanced search.
    • Edit issue

      • Edit in both text markup and visual mode.
      • Assign yourself to tickets, set co-pilot, transition state, add estimate.
      • Create issue links from Task tickets to User Story tickets.
Links to this page