2020-10-30 18:08:56 +00:00
---
2020-11-16 03:09:03 +00:00
stage: Create
group: Ecosystem
2020-10-30 18:08:56 +00:00
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#designated-technical-writers
---
2019-05-06 00:56:13 +00:00
# Setting up a development environment
The following are required to install and test the app:
1. A Jira Cloud instance
2019-07-09 00:20:40 +00:00
Atlassian provides free instances for development and testing. [Click here to sign up ](https://developer.atlassian.com/platform/marketplace/getting-started/#free-developer-instances-to-build-and-test-your-app ).
2019-05-06 00:56:13 +00:00
1. A GitLab instance available over the internet
For the app to work, Jira Cloud should be able to connect to the GitLab instance through the internet.
2019-09-05 08:59:03 +00:00
To easily expose your local development environment, you can use tools like
2020-08-06 15:09:42 +00:00
[serveo ](https://medium.com/automationmaster/how-to-forward-my-local-port-to-public-using-serveo-4979f352a3bf )
2019-09-05 08:59:03 +00:00
or [ngrok ](https://ngrok.com ). These also take care of SSL for you because Jira
requires all connections to the app host to be over SSL.
2019-05-06 00:56:13 +00:00
2019-07-09 00:20:40 +00:00
## Installing the app in Jira
2019-05-06 00:56:13 +00:00
1. Enable Jira development mode to install apps that are not from the Atlassian Marketplace
1. Navigate to **Jira settings** (cog icon) > **Apps** > **Manage apps** .
1. Scroll to the bottom of the **Manage apps** page and click **Settings** .
1. Select **Enable development mode** and click **Apply** .
1. Install the app
1. Navigate to Jira, then choose **Jira settings** (cog icon) > **Apps** > **Manage apps** .
1. Click **Upload app** .
1. In the **From this URL** field, provide a link to the app descriptor. The host and port must point to your GitLab instance.
For example:
2019-07-12 08:09:23 +00:00
2020-03-25 06:07:58 +00:00
```plaintext
2019-05-06 00:56:13 +00:00
https://xxxx.serveo.net/-/jira_connect/app_descriptor.json
```
2019-07-12 08:09:23 +00:00
2019-05-06 00:56:13 +00:00
1. Click **Upload** .
If the install was successful, you should see the **GitLab for Jira** app under **Manage apps** .
You can also click **Getting Started** to open the configuration page rendered from your GitLab instance.
_Note that any changes to the app descriptor requires you to uninstall then reinstall the app._