The COM add-in comes as an executable, installable file (.exe or .msi), which can be used on Windows computers.

The COM add-in is not available on other platforms.

Depending on your environment, one of the following deployment methods can be used. If you just want to test the add-in first, we recommend starting with the “Per User” installer, as it’s the most easiest to start with.


Per User

The per-user installer is the default download in the Jira admin area. If you quickly want to get started or distribute this to your users manually, this is usually the best option. It has the following benefits:

  • Does not require administrative rights to install

  • Has an automatic updater, which will keep the add-in fresh

Download per-user installer (.exe)

Download per-user installer (.msi)

Non-Administrative rights

To make it possible to run without administrative rights, our per-user installer installs itself into this folder:

%LocalAppData%/OutlookEmailForJira
CODE

If you do not want this, and instead prefer an installation to %ProgramFiles%, please check the other installer types.

Automatic updater

If you do not use a central software deployment at your company, keeping the users computer up to date is usually quite hard. For this reason, most popular software features an automatic update routine, which will keep the software up to date. Chrome & Firefox are certainly the most popular examples. For this reason, we also ship the per-user installer with an auto-updater. It will check for new versions of our add-in twice per day.

A few notes:

  • Software updates we deploy are digitally signed and cannot be forged

  • Software updates are always done via a secure TLS connection

  • We test updates often before releasing them to your users

If you want to learn more about the endpoints the updater uses, please check this article.

Internally, we currently have multiple release channels which cannot be chosen (yet). As we are currently early in the stage of rolling out V3, we try to release updates more often (every second week). This will become less frequent starting early 2020, at least for users not in a fast channel.


On Citrix / Terminal Server / VDI

To install the COM add-in on a central VM or virtualized environment, we recommend using the per-machine installer, which you can download from the “More Options” button in Jira. If you do not want to have an automatic updater in place, you can also use this option.

This installer requires administrative permissions to install, since it writes to %ProgramFiles%

Download per-machine installer (.exe)

Download per-machine installer (.msi)

Port configuration

The add-in opens a local port to show it’s UI in a webview. In case this is restricted in your environment, you’ll need to allow users to open a port, like described in this article: COM Add-in error on startup

User Data

This version of the COM add-in stores the user data (e.g. login token, preferences) in

%LocalAppData%\OutlookEmailForJira
CODE

This is the same as the per-user installer. This makes upgrades to the add-in pretty easy, since no data needs to be kept in the %ProgamFiles% install folder.

In case you need to store the user data in the roaming application data folder instead, please execute the per-machine installer with the following command

outlook_email_for_jira_dist.exe DATA_DIR=ROAMING
CODE

This will add a new file to the install directory (%ProgramFiles%\OutlookEmailForJira\useRoamingData.enabled), which instructs the add-in to write it’s data files to the roaming folder (%AppData%\OutlookEmailForJira). Please note, this does not apply to the log files, these will still go to local application data (for now).

Updates

To update the add-in to a new version, you’ll need to download the new version from Jira. Please make sure to use the correct one (per-machine). You can either uninstall the old version first or just run the new installer directly - it will take care of removing the old files. In any case, the user data (login, preferences) will be kept, so after a restart of Outlook, everything will continue to work as before!

Default Configurations

It is possible to add a default configuration for the COM add-in. Most importantly it can be used to default the Jira url to make it easier for the users. It requires a dataStore.json file in the Installation folder. This configuration file will get copied into the user-specific AppData folder on first-use.

Create the configuration file

You can download an example file here and adjust to your needs. The example contains all settings to adjust and a server system configured.

dataStore.json

Please make sure the Jira base url is correctly encoded.

Copy the file into the Installation folder.

The file needs to be placed in. (data folder needs to be created manually)

%Program Files%/Outlook Email for Jira/data
CODE

Software Deployment Tools

We create our installer using the “AdvancedInstaller” tool. We provide a bootstrapped .exe-version, as well as a bare .msi-file. You should be able to use either of those files with the most popular software deployment tools, such as SCCM. Both files support all common Windows Installer command line switches, e.g. /qn for silent installs.

If you should notice an incompatibility, please let us know, we’ll make sure to provide you with a fitting installer file.