Feedback Edit

Install extensions for on-premises servers

  • Article
  • 4 minutes to read

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

To add new features and capabilities to your Azure DevOps Server, install extensions from the Azure DevOps Marketplace.

Tip

For more information about building your own extensions, see developing and publishing extensions.

Prerequisites

Note

To use an existing Azure subscription for billing, you must have at least Co-administrator permissions for that subscription. If you don't have permissions, have an Azure Account Administrator or Service Administrator go to the Azure portal and add you as Co-administrator to the Azure subscription that you want to use for billing. Co-administrator permissions are available only in the Azure portal.

Your project collection reuses your Azure subscription for future Marketplace purchases. Where can I find more info about Azure billing?

Install extensions from the Marketplace

  1. From your Azure DevOps Server home page (https://{server}:8080/tfs/), go to the project collection where you want to install the extension.

  2. From your project collection, go to the Marketplace.

    Browse Marketplace in new navigation

  3. Find and select the extension that you want to install.

    Select an Azure DevOps Server extension

    Azure DevOps Server is connected to the Marketplace, so the Marketplace automatically filters and shows on-premises extensions only.

  4. Select Install.

  5. Confirm the project collection where you want to install this extension.

    Select project collection

  6. Finish installing your extension.

  7. Assign the extension to users who need access. Otherwise, you can go to your project collection to use your extension. Tell your team about this extension, so they can start using its capabilities too.

    Extension installed

    Need help?

Install extensions when disconnected

When disconnected from Azure DevOps Server, you can install free and preview extensions by downloading them, uploading them to your Azure DevOps Server, and then installing them in a project collection. You can't install extensions when you're disconnected from Azure DevOps Server.

Who can upload extensions to a server?

Team Foundation Administrators with Edit instance-level information permissions can upload extensions.

Download from the Marketplace

  1. Sign in to the Marketplace > Azure DevOps.

  2. Find the extension that you want to install.

    View Find the extension you want to install.

  3. Download and save your extension.

    Download and save your extension

Upload extension

  1. Go to your home page (https://{server}:8080/tfs/).

  2. Browse for your downloaded extensions (https://{server}:8080/tfs/_gallery).

  3. Manage your extensions.

    Manage your extensions

  4. Upload the extension that you downloaded.

    Find and upload your downloaded extension

    Why can't I upload extensions?

Tip

The maximum size for upload is 25MB. If you can't work around this requirement, Report a problem in the Developer Community.

Install extension in your project collection

  1. Select and install the extension that you uploaded.

    Select extension, then select Install

  2. Choose the project collection where you want to install the extension.

    Select project collection, select Continue

  3. Review the permissions that the extension gets when it's installed. Finish installing your extension.

    Review the permissions granted to this extension

    You can now go to your project collection to use your extension. Also, remember to tell your team about this extension, so they can start using its capabilities too.

Install pre-installed extensions (first-party) for disconnected TFS

Note

This section is only for adding pre-installed extensions (first-party), if you're installing extensions that aren't pre-installed with TFS, head to the Disconnected TFS section.

With first-party extensions that come pre-installed with TFS, there's an alternate method of installation that prevents compatibility issues.

In this case, you can manage extensions in disconnected TFS by completing the following steps:

  1. Hover over the shopping bag and select Manage extensions

    Select Manage extensions.

  2. Once on the Extensions page, select Browse local extensions

    On the Extensions page, Browse local extensions

  3. Scroll down until you see the Plan and track category, which includes Delivery Plans. Select Delivery Plans.

    Choose your extension

  4. You're redirected to a local extension page for Delivery Plans where you select Install. Installation works when you're both online and offline.

    Delivery plans extension gallery

Install Azure DevOps Server extensions from the Marketplace

  1. Open your Azure DevOps Server home page (https://{server}:DefaultCollection).

  2. Open the extensions menu and choose Browse Marketplace.

    Browse Marketplace

  3. Find the extension that you want to install. Use the search box to filter the list of extensions.

    Select an extension

  4. Select the extension and choose Get or Get it free. Or, for some third-party extensions, choose Get Started to show pricing information and extension-specific installation instructions.

    Get the extension

    If you don't have permission to install the extension, you can request an administrator to install it for you. Your request is stored in Azure DevOps Server ready for attention from an administrator.

  5. Select the project collection where you want to install this extension and choose Install.

    Select project collection and choose Install.

  6. After installation is complete, go to the project collection or return to the Marketplace to find other extensions.

    Installation done

Several extensions are pre-installed in the local extensions gallery. Users can install these extensions without requiring an external connection to Marketplace or the internet.

Tip

Extensions that have previously been installed from Marketplace appear in the local gallery automatically so that they can easily be installed into other project collections.

  1. Open the extensions menu and choose Manage Extensions.

    On the extensions menu, choose Manage extensions.

  2. In the Extensions page, choose Browse local extensions

    Browse local extensions

  3. Choose the extension you want to install.

    Choose a local extension

  4. Select the project collection where you want to install this extension and choose Install.

    Select the project collection where you want to install this extension and choose Install.

  5. After installation is complete, go to the project collection or return to the Marketplace to find other extensions.

    Installation done

Manage Azure DevOps Server extensions

Use the Extensions page to manage installed extensions.

Disable or uninstall an extension

  1. Open the extensions menu and choose Manage Extensions.

    Manage extensions

  2. In the Manage tab, open the shortcut menu for the extension.

    Disable or uninstall an extension

  3. Choose Disable or Uninstall, as required.

Review and install requested extensions

  1. Open the extensions menu and choose Manage Extensions.

    Open the extensions menu and choose Manage extensions.

  2. Open the Requested tab, review requests, and approve or reject them, as appropriate.

  3. Filter the list of requests by using the Status drop-down list at the right end of the tabs bar.

    Filtering the list of extensions