There are currently some incompatibilities and differences when registering your existing Connect app on Forge.
If you're blocked by one of these limitations, make sure you watch the related Jira issue (press W on your keyboard). Along with keeping you up to date, this also helps us prioritize the most needed features.
At present, you shouldn't attempt to register your app on Forge if your app uses these Connect features:
When adopting Forge for your Connect app, there are some differences and caveats to what a developer may be used to:
The first update to Forge will require Admin approval (major update)
Non-admin-approved updates will roll out quickly, without callbacks
Updates to Forge will show as a 'new installation' in audit log
Some modules can not be migrated from Connect to Forge types
Currently even without changing anything else, publishing your existing app as a Forge app will trigger a major update for Admins. If you prefer to minimize the number of major version app updates for your customers, we recommend bundling up an app update with the introduction of your first Forge module.
Once your app is registered with Forge, the enabled
and disabled
Connect lifecycle events will no longer be sent.
See Versioning in Connect Vs Forge for more detail on how versioning is different.
For a Forge app using Connect modules, updates that do not require admin approval - automatic updates (micro
updates for Connect, minor
updates for Forge) will roll out at the same speed as Forge updates (within minutes).
Once your app is registered with Forge, the installed
Connect lifecycle event will no longer be sent during automatic updates.
See Versioning in Connect Vs Forge for more detail on how versioning is different.
Watch this Jira issue for updates.
When registering your existing Connect-only app on Forge, the licensing must stay consistent.
A paid connect app (enableLicensing: true
in the descriptor) must be replaced by a paid Forge app (app.licensing.enabled: true
), and an unpaid Connect app by an unpaid Forge app.
The licensing status of the app can't be changed until all installations have migrated to Forge. There are currently no plans to address this, as it only affects apps that are in the process of updating to a Forge version.
An update that moves from Connect-only to adopting Forge shows as a new installation in the UPM audit log. There are currently no plans to address this.
Some modules do not yet support migrating their Connect equivalent to a Forge version while retaining existing data.
The only supported module type currently is Confluence Macros.
app.connect.key
can and should be set differently in different environments, but the field in the manifest is not environment-specific. This means app.connect.key
needs to be changed to the appropriate key before running forge deploy
to different environments.
See Developing with Connect and Forge for more information on how to best handle app keys.
If you register your Connect app on Forge, you will still be able to use the App Migration Platform including any migration webhooks you have defined and any migrations to Connect modules. However, if your app uses both Connect and Forge modules for custom fields or workflow rules, we don't currently support migrating to both at once. If you want to migrate data from your server modules to Forge modules, please reach out to us, or join the server to Forge EAP.
Now that you're aware of the differences, you're ready to start adopting Forge in your Connect app.
Rate this page: