Set up upstream sources

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

With Azure Artifacts upstream sources, you can streamline your package management by using a single feed to store both the packages you publish and those you consume from external feeds and public registries such as npmjs.com, NuGet.org. When an upstream source is enabled on your feed, Azure Artifacts will automatically save a copy of any package installed by a collaborator or higher from upstream.

Enable upstream sources in a new feed

  1. Sign in to your Azure DevOps organization, and then navigate to your project.

  2. Select Artifacts, and then select Create Feed.

  3. Provide a Name for your feed and select its Visibility and Scope settings. Make sure to check the Include packages from common public sources checkbox to enable upstream sources.

  4. Select Create when you're done.

    A screenshot showing how to create a new feed.

Important

Maven snapshots are not supported in upstream sources.

Enable upstream sources in an existing feed

  1. Sign in to your Azure DevOps organization, and then navigate to your project.

  2. Select the gear icon button gear icon to navigate to your feed settings.

  3. Select Upstream sources, and then select Add upstream source.

  4. Select Public source, and then select a Public source from the dropdown menu.

  5. Select Save when you're done, and then select Save once more in the top right corner to preserve your changes.

Note

Custom public upstream sources are only supported with npm registries.

Add a feed in the same organization as an upstream source

  1. Sign in to your Azure DevOps organization, and then navigate to your project.

  2. Select the gear icon buttongear icon to access your feed's settings.

  3. Select Upstream sources, and then select Add Upstream.

  4. Select Azure Artifacts feed in this organization.

  5. Select the desired Feed from the dropdown menu to add it as an upstream source. Then, select the View and choose the Package type(s) you wish to use. Optionally, you can also modify the name of your upstream source.

  6. Select Save when you're done.

    A screenshot showing how to add a feed in your organization as an upstream source.

Add a feed in a different organization as an upstream source

  1. Sign in to your Azure DevOps organization, and then navigate to your project.

  2. Select the gear icon buttongear icon to access your feed's settings.

  3. Select Upstream sources, and then select Add Upstream.

  4. Select Azure Artifacts feed in another organization.

  5. Enter your Azure Artifacts feed locator in the following format:

    • Organization scoped feed:

      azure-feed://ORGANIZATION_NAME/FEED_NAME@VIEW
      
    • Project scoped feed:

      azure-feed://ORGANIZATION_NAME/PROJECT_NAME/FEED_NAME@VIEW
      
  6. Select the Package type(s) you wish to use and provide a name for your upstream source.

  7. Select Save when you're done.

    A screenshot showing how to add a feed in a different organization as an upstream source.

Examples

Note

You must be a Feed and Upstream Reader (Collaborator), a Feed Publisher (Contributor), or a Feed Owner to install new packages from upstream. A copy of each upstream package is saved to the feed on first use. Packages already saved from upstream sources can be used by Feed Readers.