• Documentation

Managing an installed app

As an administrator, you can manage app administration tasks like updating, uninstalling, troubleshooting, and configuring apps in the Connected apps page.

Update an app

App developers may periodically introduce security updates, performance improvements, and new features to their apps. Most updates will be automatically applied to your apps. However, for some major updates (such as app permission changes) admin approval is required.

We recommend that you keep your apps updated to ensure that you get the latest improvements. As a site/organization administrator, you can update apps installed on any product.

There are two ways to view and update your cloud apps: from your product instance or from Administration.

To check which apps have available updates:

  1. Select Apps in the global navigation.

  2. Click on Manage your apps which will direct you to Connected apps.

  3. Apps with available updates will have an UPDATE status next to their names. Click the app’s action button and select View app details.

  4. Select Update from the app details screen to update the app to the latest version.

  5. Repeat this process for all other apps you need to update.

Uninstall an app

Site or organization administrators can uninstall apps from an Atlassian site. You should warn your users that the app is about to uninstalled from your site beforehand.

To uninstall an app from your site:

  1. Select Apps in the global navigation.

  2. Click on Manage your apps which will direct you to Connected apps.

  3. Select View App Details for the app.

  4. Select Uninstall.

Uninstalling an app requires all connected users to be removed first. As this is a slow operation with large numbers of users, the process is automated for you. You can monitor the progress from the connected apps screen. Once all users are removed, the app is uninstalled.

Troubleshoot an app

When you install some apps (such as Forge), the app vendor gets access to your app logs. This means that if you experience an issue with the installed app, the vendor can use the logs to quickly solve the problem. If you want to check the content of the logs, you can download and review them. You can also disable log access for Forge apps at any time.

Granting log access will give vendors access to logs for up to 60 days ago, even if sharing wasn’t active before then. When you disable their access to logs, they will no longer be able to see any logs that have been created inside your site.

You can disable log access at any time.

Download logs

To download logs:

  1. Select Apps in the global navigation.

  2. Click on Manage your apps which will direct you to Connected apps.

  3. Next to the app you want to download logs for, click the action button and then select Download logs. Note: some apps may not support logs.

    A modal appears as seen below, giving a preview of the logs you're about to download.

  4. If necessary, use the date picker to choose a date range and select Apply.

  5. Select Download.

  6. Send the downloaded log file to the app vendor. If you have any concerns that the logs might contain personal or confidential data, you can always review the file before sending it.

The dates in the date picker are in your local time, and the dates in the logs are in Coordinated Universal Time (UTC).

A preview of the logs you're about to download, with start and end dates buttons.

Disable log access

To disable log access:

  1. Select Apps in the global navigation.

  2. Click on Manage your apps which will direct you to Connected apps.

  3. Next to the app you want to enable logs for, select View app details.

    A screen appears, showing the details of your app and the controls for enabling or disabling access to your site's logs.

  4. Under the App logs access section, select Disable log access.

  5. A modal appears with more details about disabling access. Select Disable.

The vendor will no longer be able to see any logs that have been created inside your site. You can re-enable log access at any time, from the same screen, and this will give vendors access to logs for up to 60 days ago, even if access was previously disabled.

You can check your log-sharing history when you access your audit logs on admin.atlassian.com.

Configure an app

Some apps expose configurable settings you can use to set up or specify preferences for the app. You should always read the documentation provided with the app to learn about such configuration options. The documentation can be accessed from the Resources section in the Overview tab of the app listing in the Marketplace.

Marketplace resource tab of an app listing which shows the app documentation

You can access configuration settings for apps that expose configuration settings and are enabled. To configure your app:

  1. Select Apps in the global navigation.

  2. Click on Manage your apps which will direct you to Connected apps.

  3. Next to the app you want to download logs for, click the action button and then select Configure. The same settings are also accessible from a link on the App details page. Both links open the same configuration page.

  4. When finished making changes, click the Save button to apply your changes.

After making app configuration changes, the host application may need to be restarted for the changes to be applied. Consult the app documentation or test the change in a staging environment before making the change to production.  

The administrative configuration options are provided by the app itself. The app is responsible for ensuring its own compatibility with the host application; if you encounter problems while attempting to configure an app, you should seek support from the app provider. For more information, click the Support and issues link in the app details view. 

Still need help?

The Atlassian Community is here for you.