2020-10-30 18:08:56 +00:00
---
2020-11-16 03:09:03 +00:00
stage: Create
group: Ecosystem
2020-11-26 06:09:20 +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/#assignments
2020-10-30 18:08:56 +00:00
---
2020-11-16 09:09:18 +00:00
# Set up a development environment
2019-05-06 00:56:13 +00:00
The following are required to install and test the app:
2020-11-16 09:09:18 +00:00
- A Jira Cloud instance. Atlassian provides [free instances for development and testing ](https://developer.atlassian.com/platform/marketplace/getting-started/#free-developer-instances-to-build-and-test-your-app ).
- 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. To easily expose your
local development environment, you can use tools like:
- [serveo ](https://medium.com/automationmaster/how-to-forward-my-local-port-to-public-using-serveo-4979f352a3bf )
- [ngrok ](https://ngrok.com ).
2019-05-06 00:56:13 +00:00
2020-11-16 09:09:18 +00:00
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
2020-11-16 09:09:18 +00:00
## Install the app in Jira
2019-05-06 00:56:13 +00:00
2020-11-16 09:09:18 +00:00
To install the app in Jira:
2019-05-06 00:56:13 +00:00
2020-11-16 09:09:18 +00:00
1. Enable Jira development mode to install apps that are not from the Atlassian
Marketplace:
2019-05-06 00:56:13 +00:00
2020-11-16 09:09:18 +00:00
1. In Jira, navigate to **Jira settings > Apps > Manage apps** .
2019-05-06 00:56:13 +00:00
1. Scroll to the bottom of the **Manage apps** page and click **Settings** .
1. Select **Enable development mode** and click **Apply** .
2020-11-16 09:09:18 +00:00
1. Install the app:
2019-05-06 00:56:13 +00:00
2020-11-16 09:09:18 +00:00
1. In Jira, navigate to **Jira settings > Apps > Manage apps** .
2019-05-06 00:56:13 +00:00
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._