Technical Anshu
Tutorials Blog
Installation Guide

Install and Configure miniOrange 2FA for Jira and Confluence

The install itself takes minutes. Doing it in the right order - checklist first, safety switches on, tested with your own account - is what this page is for.

By Technical AnshuJira and ConfluenceStep by step setup
Watch the full setup in the video - every miniOrange setting, screen by screen

This is the hands on page of the series: installing the miniOrange 2FA app on Jira, configuring the first method, and repeating it on Confluence. The video above shows every screen live - this text is your checklist to work beside it.

Jira administration - where the setup lives
Administration - Manage apps
1. Find apps - search miniOrange 2FA
2. Install - apply trial or licence key
miniOrange 2FA configuration
3. Enable method - Authenticator app (TOTP)
4. Brute force protection - ON
5. Enable for group - 2fa-pilot
The five stops of the install. Menu names can differ slightly between Jira versions and app versions - the order stays the same.
1

Before you click install - the honest checklist

  1. You are a Jira administrator, and you have a maintenance window or at least a quiet hour
  2. You have a second admin account available, tested and working
  3. You know your hosting - this app is for self hosted Jira Server and Data Center and the matching app is for Confluence. Cloud takes a different route entirely
  4. A backup of Jira exists, as before any plugin change
2

Install the app in Jira

  1. Open Administration and go to Manage apps
  2. Choose Find new apps and search for the miniOrange two factor authentication app for Jira
  3. Click install, accept the permissions, and wait for the success message
  4. Start the trial or enter your licence key when prompted

The app is paid via Atlassian and licensed per user. The trial is the right way to begin - it lets the whole pilot run before any purchase decision.

3

Configure the first method and the safety switches

  1. Open the miniOrange 2FA configuration from the administration area
  2. Enable the authenticator app (TOTP) method as the default
  3. Enable a backup method such as email OTP for recovery situations
  4. Turn on brute force protection so repeated wrong codes are blocked
  5. Optionally enable remember device for a sensible number of days on trusted office machines
  6. Save everything, then log out and test with your own account in a private window

The video shows this configuration screen by screen on a live instance - if a label on your version differs slightly, the video is the fastest way to match it.

4

Repeat on Confluence - it is a separate app

Jira and Confluence use separate miniOrange apps with separate licences. Install the Confluence 2FA app the same way, mirror the same method choices, and pilot it with the same group. Keeping both products configured the same way means users learn one habit, not two - and your support answers stay identical.

See the Complete miniOrange Setup in the Video

The full installation and configuration, done live on a real Jira and Confluence instance, step by step.

Watch Full Video
Common Questions

Is the Jira app and the Confluence app the same licence

No. miniOrange sells the 2FA app for Jira and the 2FA app for Confluence as separate Marketplace listings, each licensed per user for that product. Budget for both if you run both, and run the trial on both during your pilot.

Which Jira versions does the miniOrange 2FA app support

The Marketplace listing covers recent Jira Server and Data Center releases, and it is updated as new Jira versions ship. Check the version compatibility on the Marketplace listing against your exact Jira version before installing.

Do I need to restart Jira after installing the app

Marketplace apps install without a Jira restart in normal cases. Plan the work for a quiet hour anyway, and test the login flow with your own account immediately after configuring, before any user group is enabled.

This guide is based on the Technical Anshu video on enabling 2FA in Jira and Confluence with miniOrange. Stuck on a step - ask in the video comments and you will get an answer.