Last updated Jun 18, 2024

Understanding Atlassian in the cloud

Atlassian Connect is built to integrate with our hosted applications like Jira and Confluence Cloud. This page explains basic architecture, purchasing, licensing, and development concerns as you build your app.

Architecture overview

Even though cloud products can be packaged together for customers, each Jira and Confluence Cloud account is a separate instance.

Although each application is isolated from a security perspective, underlying resources like hardware, CPU, and memory can be shared between many customers. Servers for our cloud applications are located in the United States, Germany, Ireland, Singapore, and Australia.

Each Jira or Confluence Cloud instance is identifiable by its tenant ID. An instance URL is liable to change without warning.

Each cloud instance has a set of licensed users. For these users:

  • Email addresses are unique within an instance, but may be used across multiple instances.
  • Users are identified by key, rather than name or email. Keys are also unique within an instance but may not be unique across instances.

Your app is automatically granted a new bot user in cloud instances. These "users" appear in the user management portal, but don't count against actual user licenses. This user profile is assigned to two groups by default: atlassian-addons and product-users (like jira-users or confluence-users). Customers should not remove bot users from these groups.

Your app accesses cloud instances through the Universal Plugin Manager. Admins install your app by registering your descriptor into an instance. App installation and licensing are separate concerns.

It's possible for a cloud instance to have your descriptor installed, but not to have a valid license.

You won't receive any communication from instances that don't have your app descriptor installed. As expected, you're unable to communicate with instances that don't have your descriptor installed.

Software upgrades

Cloud instances restart regularly during maintenance windows. Weekly releases may or may not contain updates to cloud applications or other components. Generally, Jira and Confluence update versions every other week. That said, even if a product doesn't have an update, it may still be restarted.

Instances also occasionally restart outside of these windows to recover from errors, or facilitate support. After restarting, initial requests to these instances may have higher latency as caches are repopulated.

Purchasing & licensing

When cloud product customers choose a new product or app, they automatically enter a free trial period. This trial lasts 30 days, plus the time until their next bill. This means the actual trial period is between 31 and 61 days, with an average of 45 days.

Customers can choose to subscribe to products and apps on a monthly or annual basis, and can cancel accounts or apps. Canceled accounts remain valid and active until the end of the billing period.

We remove cloud product data 15 days after cancellation. For this reason, publish your own data retention policy.

Since app installation and licensing are handled separately, always check the license status on each request and serve an appropriate response.

Development checklist

Develop your app with the following concepts in mind:

See the following pages for more details:

Rate this page: