Edit

Use packages from npmjs.com

  • Article

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

The npm client is designed to work with one main registry (known as a feed in Azure Artifacts) at a time. However, it does support additional scoped registries. If you plan to use both private packages and public packages from npmjs.com, it's recommended to use upstream sources. Once you enable upstream sources in your feed, Azure Artifacts automatically saves a copy of any installed package to your feed. This offers the greatest flexibility, allowing you to use a mix of scoped and non-scoped packages in your feed, including both scoped and non-scoped packages from npmjs.com.

Prerequisites

Enable upstream sources

If you haven't created a feed yet, follow these steps to create a new one and make sure to check the upstream sources checkbox to enable them. If you already have a feed, proceed to the next step to add npmjs as an upstream source.

  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 descriptive Name for your feed, set its Visibility and Scope. Check the Upstream sources checkbox to include packages from public registries.

  4. Select Create when you're done.

Add npmjs upstream

If you checked the upstream sources checkbox during the creation of your feed, npmjs should have been added automatically. If not, you can add it manually as follows:

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

  2. Select Artifacts, and then select your feed.

  3. Select the gear icon button gear icon to navigate to Feed settings.

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

  5. Select Public source, and then select npmjs (https://registry.npmjs.org/) from the dropdown menu.

  6. Select Save when you're done, and then select Save at the top right corner to save your changes.

Install packages from npmjs

Before you save packages from npmjs, make sure your project is set up to connect to your feed. If you haven't done this yet, follow the instructions in the project setup to configure your npm project and connect to your feed. In this example, we'll install the Axios library for making HTTP requests:

  1. Navigate to npmjs at https://www.npmjs.com//.

  2. Search for the Axios package, and then select it to navigate to the details page.

  3. Copy the install command to your clipboard.

  4. In a command prompt window, navigate to your project's directory and run your install command.

    npm install axios

Note

To save packages from upstreams, you must have the Feed and Upstream Reader (Collaborator) role or higher. See Manage Permissions for more details.

View saved packages

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

  2. Select Artifacts, and then select your feed from the dropdown menu.

  3. Select npmjs from the source menu. The Axios package we installed earlier is now available in our feed. Azure Artifacts automatically saved a copy to our feed upon executing the install command.

    A screenshot showing the axios package that was saved from upstream.