Getting Started with Jirion - Connect to Jira Cloud

This takes about five minutes: install Jirion, create an API token in your Atlassian account, and sign in.

Before you start

  • A Jira Cloud site - the kind with an address like yourcompany.atlassian.net. Jira Server and Data Center are not supported.
  • Windows 11 (64-bit).
  • An Atlassian account that can sign in to your Jira site, so you can create an API token in Step 3.

Step 1: Install Jirion

  1. Download the installer from the Download page.
  2. Run it and follow the prompts. Jirion is added to your Start Menu, and you can choose to add a desktop icon too.

Step 2: Get your licence

Jirion needs a licence key to run, but while it is free you do not buy anything or fill in a form on this website. The first time you start it, Jirion's licensing window opens - choose the free trial licence and it is set up for you. You can check your licence at any time from Help → License. More about Jirion's licensing.

Step 3: Create an API token

Jirion signs in with your email address and an API token instead of your password. It is the method Atlassian provides for apps like this, and you can revoke a token at any time.

  1. Go to id.atlassian.com/manage-profile/security/api-tokens and sign in.
  2. Choose Create API token and give it a name, such as "Jirion". Atlassian asks you to choose an expiry date.
  3. Copy the token straight away - Atlassian only shows it once. Keep it somewhere safe, such as a password manager.
Use a standard token. Atlassian also offers "Create API token with scopes". Jirion needs the standard kind; a token with scopes is likely to be refused when you sign in.

Step 4: Sign in

  1. Start Jirion. If the sign-in window does not appear, choose File → Login.
  2. Enter:
    • Jira address - for example yourcompany.atlassian.net. You can paste any address from your browser while you are in Jira, even a long one; Jirion keeps just the site part.
    • Email address - the email address of your Atlassian account (not a username).
    • API token - the token you copied in Step 3.
  3. Leave the option to remember your details ticked if you do not want to enter them each time. The token is stored encrypted by Windows, for your user account only. Untick it on a shared PC.
  4. Sign in. Jirion loads your projects and opens your Dashboard.

Step 5: Find your way around

  • Dashboard - every open issue assigned to you, across all projects. Double-click one to open it.
  • File → Open Project - adds a tab for a project. Use the Versions button on a project tab to manage its versions.
  • File → Open Issue - go straight to an issue when you know its key.
  • Right-click an issue - assign it, or change its status or priority. Select several first to change them all together.
  • Edit → Options - choose a light or dark theme, and how often Jirion checks Jira for changes.

The Features page covers everything in more detail.

Troubleshooting

"Couldn't log in to Jira"

The message under it says what went wrong. Most often it is one of these:

  • The email address is not the one on your Atlassian account.
  • The token was copied incompletely, has been revoked, or has expired. If sign-in used to work and suddenly does not, an expired token is the first thing to check - create a new one.
  • The token was created "with scopes". Create a standard one instead (see Step 3).
  • The Jira address belongs to a different site from the one your account uses.

When sign-in fails, the window comes back with everything you typed still in it, so you can correct one thing and try again.

"Couldn't find ..." or "Couldn't reach ..."

Check the Jira address for typos and that you are connected to the internet (or your company VPN, if Jira is only reachable through it).

"Couldn't make a secure connection" or a proxy message

Something between your PC and Jira - often a company proxy or security software - is interfering with the secure connection. Ask whoever looks after your network, and mention the name of the site shown in the message.

"You logged in successfully, but your list of projects couldn't be loaded"

Your token is fine, but Jira did not return your projects. Try again in a moment. If it keeps happening, check that your Atlassian account can see projects in Jira in your browser.

Jirion won't start after installing

Make sure the .NET 8 Desktop Runtime (x64) is installed - this is the most common cause. You can get it from dotnet.microsoft.com/download/dotnet/8.0.

Where does Jirion keep my settings?

In your Windows user profile, in %APPDATA%\ANB Software\Jirion. They are kept separately from the program, so installing an update does not reset them.

Still stuck? Report a bug or visit Support.


Need a hand? Getting Started · Support · Report a bug · Give feedback · Donate

Jirion is an independent product of ANB Software Ltd. It is not affiliated with, endorsed by or sponsored by Atlassian. Jira and Atlassian are trademarks of Atlassian Pty Ltd.