Forge Developer

Beta

Forge Developer

Beta
Last updatedNov 10, 2020

Rate this page:

Platform limits

The Forge platform has a strong security posture and multi-tenant isolation which helps to keep all Forge apps responding fast and securely. Where required, we impose limits on the platform to ensure smooth operations for all users.

You should also familiarize yourself with the beta limitations.

Developer limits

The limits listed below apply to a developer's account.

ResourceLimitDescription
Apps100Number of apps that can be created or owned by a single developer.

App limits

The limits listed below apply to an app.

ResourceLimitDescription
App description1000The app description must not exceed the maximum character limit.
App name1 to 50An app name must be between the character limits.
App size100Maximum app size in megabytes (MB).
Base URL2048The app baseUrl must not exceed the maximum character limit.
Modules per app100Number of unique modules declared in a single app manifest must not exceed the limit.
Resources per app10Number of unique resources declared in a single app manifest must not exceed the limit.

Installation limits

The limits listed below apply to an app installation. For example, the hello-world app, installed on example.atlassian.net in the production environment.

ResourceLimitDescription
App storage100Maximum data stored in the storage API in megabytes (MB).
App storage reads50Maximum read operations per second.
App storage writes10Maximum update operations per second.
App storage queries10Maximum query operations per second.
App storage deletes10Maximum delete operations per second.

Invocation limits

The limits listed below apply to an app when it's invoked.

ResourceLimitDescription
Runtime seconds10Total runtime permitted before the app is stopped.
Log lines per invocation100Number of log entries per invocation.
Network requests100Number of network requests per invocation, excluding those made using requestJira or requestConfluence.

Resource limits

The limits listed below apply to resources bundled with an app.

ResourceLimitDescription
Bundle files10000Number of files declared in a single custom UI resource bundle must not exceed the limit.
Bundle size50Maximum bundle size in megabytes (MB) for a custom UI resource.

What happens if a limit is exceeded

The limits on this page are generally enforced through validation in the Forge CLI, where you'll receive an error straight away. These errors often have trivial fixes, such as shortening your app's name.

For the resource-bound limit errors, such as the total number of apps, you need to remove some old apps. You can uninstall an app with the forge uninstall command. Once all installations of that app are removed, delete it from the https://developer.atlassian.com/apps/ screen.

What happens to a suspended app

An app may be temporarily suspended if it's negatively impacting the Forge platform or supporting infrastructure.

When an app is suspended, the following actions are not available:

  • Invoking the app:

    When an app is suspended, it will not be invoked by any existing installations. Instead, returning an App is currently unavailable, please try again later error.

  • Installing the app on new sites:

    Users trying to install the app receive an App installation is not available while the app is suspended error.

  • Deploying installing the app:

    The forge deploy command returns an App management is unavailable while the app is suspended error.

If your app is suspended, we will contact you as soon as possible to help diagnose the issue by raising a ticket on the Developer support Jira project where you'll be mentioned. If you're not yet a Jira user, we will email you with a link to the issue.

If you've got an issue with app limits and you've not been contacted, you can seek assistance from the Forge developer community.

See the Forge Terms for more information.

Rate this page: