Install extensions for on-premises servers

Azure DevOps Server | TFS 2018 | TFS 2017 | TFS 2015.3

To add new features and capabilities to your Azure DevOps Server or Team Foundation Server (TFS), install extensions from the Visual Studio Marketplace.

Tip

To learn 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 TFS extensions from the Marketplace

  1. From your TFS 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 a TFS extension

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

  4. Based on the extension that you select, install or buy the extension.

    • For free or preview extensions, select Install.
    • For extensions that you haven't paid for access yet, select Buy.
    • For extensions that you've already paid for access, expand Buy, and select Install for paid users.
    Install or buy the extension
  5. Confirm the project collection where you want to install this extension.

    Select project collection
  6. If you chose a paid extension, select the Azure subscription that you'll use to pay for extension access.

    For paid extensions, select an Azure subscription for billing

    Select the number of users who need paid access to the extension.

    Select number of users who need paid extension access
  7. Finish installing your extension.

  8. If you installed a paid extension, make sure to assign the extension to users who need access. Otherwise, you can go to your project collection to use your extension. Also, tell your team about this extension, so they can start using its capabilities too.

    Extension installed

    Need help?

Install TFS extensions when disconnected

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

Who can upload extensions?

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

Who can install extensions?

Project Collection Administrators with Edit collection-level information permissions can install extensions. If you don't have permissions, you can request extensions instead.

Download from the Marketplace

  1. Sign in to the Marketplace > Azure DevOps.

  2. Find the extension that you want to install.

    View View
  3. Download and save your extension.

    Download and save your extension

Upload extension to TFS

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

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

    TFS 2015 Update 3

    Browse TFS extensions

Upload extension to TFS

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

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

    Browse TFS extensions

Upload extension to TFS

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

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

  3. Manage your extensions.

    Manage extensions
  4. Upload the extension that you downloaded.

    Find and upload your downloaded extension

    [Why can't I upload extensions?]

Install extension in your project collection

  1. Select and install the extension that you just 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 is an alternate method of installation that prevents compatibility issues.

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

  1. Hover over the shopping bag icon and select Manage extensions

    Manage extensions

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

    Browse local extensions

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

    Delivery plans extension

  4. You're redirected to a local extension page for Delivery Plans where you select Install. This works when you are 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 if it is a paid extension, 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 do not have permission to install the extension, you can request an administrator 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

  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.

    Manage extensions

  2. In the Extensions page, choose Browse local extensions

    Browse local extensions

  3. Choose the entension you want to install.

    Choose a local extension

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

    Select project collection

  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.

    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