Timebomb licenses for testing server apps (copy)

Last updated by Atlassian Oct 23, 2023

While using UPM's License API you will likely find yourself wanting to test out your app with a valid license entered.

Moving your app and customers to cloud gives you step-by-step guidance if you're considering cloud or have migrating customers. The end of support for server is Feb 15, 2024.

General testing

The following license will work for any Marketplace-enabled server app. Click on the Copy button for any of the licenses below to copy the key. Then, paste the copied key into a license key field:

3 Hour Expiration

Additionally, the following licenses allow you to test what happens when a valid license becomes expired:

60 Second Expiration

10 Second Expiration

If you're running Jira Software, Jira Core or Jira Service Desk and need to license any of them, you can do so by using the following license key on the Versions & licenses page:

3 hour expiration for all Atlassian host products*

*This excludes Hipchat Data Center

Testing for license error conditions

If you are testing with the SDK, your Atlassian host product (Jira, Confluence, etc.) generates with a 5 user test license for app developers. You can install a app license that supports more users than this; you cannot install one that supports fewer. This is important, as many of the errors returned by the Licensing API result from mismatches between the host product and the app license.

To test a nearly expired evaluation license:

10 user evaluation license, expires in 3 hours

To test an expired evaluation license:

10 user evaluation license, already expired

To test a nearly expired license:

10 user license, expires in 3 hours

To test an already expired license:

12 user license, already expired

To test a user-mismatch error (non-Bamboo host product) or edition-mismatch error (Bamboo host product):

2 user / 1 remote-agent license, expires in 3 hours

To test a version-mismatch error:

10 user license, maintenance expired before your app was built

To test a type mismatch error, do the following:

1. Enter a new host product license:

   10 user starter non-eval host product license, expires in 3 hours

2. Enter the app license:

   10 user license, expires in 3 hours

   You enter the app license after entering the host license--otherwise the previous app license is cached as "valid" for a short time.

Testing Data Center compatibility

To test licensing for your Data Center compatible app, use a Data Center host product license and a Data Center app license.

Data Center host product licenses

10 user Jira Software Data Center license, expires in 3 hours

10 user Jira Service Desk Data Center license, expires in 3 hours

10 user Confluence Data Center license, expires in 3 hours

10 user Bitbucket Data Center license, expires in 3 hours

10 user Bamboo Data Center license, expires in 24 hours

Data Center app licenses

10 user Data Center app license, expires in 3 hours

10 user Data Center app license, expires in 60 seconds