### Problem Atlassian disabled Connect-based manual app installs as of 2026-03-31. The existing manual install instructions at [docs.gitlab.com](https://docs.gitlab.com/administration/settings/jira_cloud_app/#install-the-gitlab-for-jira-cloud-app-manually) no longer work because they rely on uploading a Connect app descriptor in Jira's development mode. This affects self-managed GitLab customers who cannot use the Marketplace listing (e.g., due to network restrictions or policy). Ref: Slack thread in `#f_jira_integrations` ([link](https://gitlab.slack.com/archives/C03EZMMCPQX/p1775506662983279)) ### What needs to happen 1. Determine the Forge-equivalent manual install method (e.g., Forge Custom UI install, private Marketplace listing, or Forge CLI `forge install` for self-managed instances) 2. Update the admin docs (`doc/administration/settings/jira_cloud_app.md`) to replace or supplement the broken Connect-based instructions 3. Update the user docs note added in [gitlab-org/gitlab!227073](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/227073) with the final instructions ### Context - [gitlab-org/gitlab!226639](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/226639) added Forge migration docs for Marketplace users - [gitlab-org/gitlab!227073](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/227073) added a placeholder note acknowledging manual installs are affected - The `gitlab-jira-forge` repo README already references self-managed configuration via CI/CD variable overrides, but there's no end-to-end install guide for customers