Product

Overview

How it works Watch it work All 35 features Screenshots How ForgeRepo™ is secured

Keep bad packages out

Malware scanning Typosquat detection Dependency confusion protection Cooling off new releases Allow lists and block lists

When something goes wrong

Kill switch Who has it Lockdown and degraded modes Vulnerability monitoring

Developers and approvals

Requests and auto approve Check, walk and review Waivers Dry run
Formats

Languages

Private npm registry PyPI proxy and private index Private NuGet feed and proxy Maven repository proxy RubyGems mirror Composer and Packagist proxy

Apple, containers and Linux

CocoaPods CDN mirror Swift package registry Docker registry mirror RPM mirror for dnf and yum APT mirror for Debian and Ubuntu

Use it as

An npm firewall Artifacts, SBOMs and lifecycle More than one node SSO, roles and allow lists
Learn

Guides

Learn secure development Secure coding Secure pipelines Unsafe vs safe Security and development

Supply chain

Supply chain attacks, 2016 to 2026 Software supply chain security
Compare Side by side, all four ForgeRepo™ vs JFrog ForgeRepo™ vs Sonatype ForgeRepo™ vs Cloudsmith
Docs

Start

Getting started Download All documentation Questions

For developers

npm setup pip setup docker login Push a Docker image CI basics

For administrators

First setup Rules and their order Six incidents, walked through Backup and upgrade
Pricing Install it

Formats and running it

A private NuGet feed and NuGet proxy

Switch on NuGet feed under Settings, Registries, Package types, add nuget.org as an upstream, and the box answers /nuget/v3/index.json for dotnet, nuget.exe and Visual Studio.

Put a nuget.config next to the solution, with <clear /> so nuget.org is not asked directly, and the token read from the environment:

<configuration>
  <packageSources>
    <clear />
    <add key="company" value="https://packages.example.com/nuget/v3/index.json" />
  </packageSources>
  <packageSourceCredentials>
    <company>
      <add key="Username" value="your-user-name" />
      <add key="ClearTextPassword" value="%REPO_TOKEN%" />
    </company>
  </packageSourceCredentials>
</configuration>

The upstream is https://api.nuget.org/v3/index.json, or the index.json of a private feed such as Azure Artifacts with a user name and token. A package is summed up once from the feed's registration pages: its own spelling of the id, every version, when each was published, its license and its dependencies. The version list dotnet restore reads and the registration dotnet add package reads both come from that summary through one filter (kill switch, quarantine, rules, safe version resolution and cooling off), so the two never disagree. Every .nupkg is checked again when it is asked for, hashed, refused unless it is a zip, and then scanned like any other file.

Rules match ids without case, so Newtonsoft.Json and newtonsoft.json are one rule. A bare version is exactly that version. NuGet ranges like [13.0,14.0), floating versions like 13.* and comparators like >=13.0 <14 work too. When something is refused, dotnet prints the reason from the X-NuGet-Warning header, and the refusal opens a request for an approver.

Pushing your own packages

Reserve an id or a prefix like Acme.* under Reserved names, then push with a token whose owner is a publisher, approver or admin:

dotnet nuget push "nupkgs/*.nupkg" --source https://packages.example.com/nuget/v3/index.json --api-key "$REPO_TOKEN"

Only reserved ids can be pushed, and a reserved id is never fetched from nuget.org, so nobody can publish the same id in public and have it restored instead. The id, version, license and dependencies are read from the .nuspec inside the package. A pushed version never changes: pushing it again is refused, and dotnet nuget delete is refused too. A new push is held until its malware scan is clean, or until an admin releases it.

What applies, and what does not

Allow and block rules, the kill switch, quarantine, cooling off, malware scanning (the OSV known malicious check included), license policy, requests and auto approve all work for NuGet. Advisories come from OSV's NuGet feed, for safe version resolution and the scheduled scan. Licenses are read from licenseExpression only, so an older package that points at a license url counts as unknown.

Honest limits: there is no search, so the Browse tab in Visual Studio finds nothing and packages are added by name. Typosquat checks, provenance checks and the dependency tree walk are for npm and PyPI, not NuGet. Repository signatures and the catalog are not served.

NuGet rules, with ids and NuGet version ranges.

In short

  • NuGet v3 feed for dotnet, nuget.exe and Visual Studio
  • Proxy for nuget.org or a private feed such as Azure Artifacts
  • dotnet nuget push for reserved ids, versions never change
  • NuGet ranges, floating versions and comparators in rules
  • Refusal reasons shown by dotnet through X-NuGet-Warning
  • No search yet, packages are added by name

In the documentation

Goes well with

  • Dependency confusion protection Reserve your npm scopes, PyPI prefixes, image namespaces and NuGet ids. A public package with your internal name is never fetched.
  • Maven repository proxy mvn, Gradle and sbt through Maven Central, Nexus or Artifactory. Every file checked against its .sha1.
  • Allow lists and block lists Whitelist or blacklist by name, scope, wildcard or version range, for every type. A blocked version is not even listed to the client.

One container, about two minutes

A Linux box with Docker, or one without it, and a reverse proxy for TLS. The installer does the rest and it is safe to run twice. Free, MIT licensed, nothing to sign up for.