Snipe-IT for Jira

Open source asset management in Jira

Documentation

This is the documentation for the Atlassian Jira app Snipe-IT for Jira.

Installation

Head to the settings within Jira. Note that administrator privileges are required to access the settings.

In the menu on the left side, navigate to “Find new apps” under the “apps” category. Search for “Snipe-IT”, wait until the entry “Snipe-IT for Jira” is shown and proceed to “Install” the app.

Do you want to migrate your data from Atlassian’s Snipe-IT beta app to “Snipe-IT for Jira”? No problem! When you setup your new app, your linked Snipe-IT assets from the old beta app will be automatically migrated. Then, you can uninstall the beta app without losing any asset history.

Setting up your connection to Snipe-IT

Once the app has been installed, proceed to configure the app either by clicking on the “Configure” button in the app listing or navigating to the Snipe-IT configuration in the Jira app setting menu.

Enter the URL of your Snipe-IT instance and an API key. You can generate an API key in the Snipe-IT web interface, by going to your account dropdown in the top right and clicking on “Manage API Keys”:

Create a new “Token” and give it an arbitrary name, e.g. “Snipe-IT for Jira”. Copy the Token into the “API key” field in the configuration of Snipe-IT for Jira.

Once you confirm the URL and API key by clicking on “Check connection and Save”, the app will check if it can connect to your Snipe-IT instance and proceed to sync all assets with Jira.

The app will sync all assets from Snipe-IT to Jira once an hour. You can also start a sync manually by clicking on the “Run manually” button in the configuration.

Using assets in Jira issues

The assets can now be used in any Jira Custom Field of type “Asset”. By default, a “Linked assets” field is created that can be added to any screens where assets are being used.

Note that you can also add multiple asset custom fields and limit which Snipe-IT asset categories are used within them. To achieve this, configure the custom field and click on “Edit Filters”, where you can add categories the field should use.

Support

If you encounter any issues, feel free to send us an email at support@codefortynine.com. We usually reply within one business day.

 

Thanks for using Snipe-IT for Jira!