Get started

This section covers the practical setup steps from start to finish. By the end, you will have the app installed, your first service model deployed, and confirmation that Jira Service Management work items can reference the objects inside it. If something does not behave as expected, the troubleshooting page at the end of this section has you covered.

---

What is in this section?

Requirements Before You Begin Before touching the Marketplace, make sure your environment is ready. This page covers the Jira Service Management and Assets prerequisites, permission requirements, and the licence tier you need. Five minutes now saves an hour of troubleshooting later.

Installing LaunchPad Step-by-step installation from the Atlassian Marketplace. Covers finding the app, approving permissions, and confirming the installation completed successfully.

First Launch Explained What happens the first time you open LaunchPad after installation. This page walks through the initial screen, the service model catalogue, and what to expect before you deploy anything.

Troubleshooting Installation If something went wrong during installation or first launch, start here. Covers the most common issues: permission errors, Forge initialisation delays, Assets not appearing, and licence-related problems.

---

Work through these in order

The four pages follow a natural sequence. Requirements first, then installation, then first launch, then troubleshooting if needed. Most installations complete without hitting the troubleshooting page at all.

---

Where to next

With LaunchPad installed, point it at your Jira instance to see what's already there. The Analysis menu has two tools, and neither changes anything. Environment Analysis scans your whole instance and recommends which service model to install. Request Flow Analysis audits a single project's fields and request types, then flags enrichment opportunities such as free-text fields that could become structured object pickers.