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 Composer repository and Packagist proxy

Switch on Composer repository under Settings, Registries, Package types, add Packagist as an upstream, and the box answers /composer/ as a Composer repository.

Add the box as a repository, turn Packagist off, and save the login once for the machine:

composer config repositories.company composer https://packages.example.com/composer
composer config repositories.packagist.org false
composer config --global http-basic.packages.example.com your-user-name "$REPO_TOKEN"

The upstream is https://repo.packagist.org. Rules are written on names like monolog/monolog or symfony/*, and take composer.json constraints like ^3.0 or >=1.2 <2.0.

The metadata composer reads lists only allowed releases. Each release names one exact commit: the box fetches that commit's zip once (from codeload.github.com for GitHub, so there is no API rate limit to hit), checks it against any shasum the metadata gives, keeps and scans it, and points composer at the kept copy. The git source is taken out of every release, so composer cannot fall back to a clone and get round the checks.

A composer.lock made before the switch still points at GitHub. Run composer update once through the box and commit the new lock file. The Check page can also review a composer.lock or composer.json against the rules before anyone installs.

What applies, and what does not

Rules, the kill switch, quarantine, cooling off (Packagist gives a publish time for each release), malware scanning (the OSV known malicious check included), license policy from composer.json, requests, auto approve and safe version resolution all apply. Advisories come from OSV's Packagist feed.

Honest limits: branches like dev-main are not releases and are not served, so a package pinned to a branch has to move to a tag. Private packages are not published here. Typosquat checks, provenance checks and the tree walk are not offered for Composer.

packages.example.com/_admin/
Reviewing a lockfile: every package judged against the rules and the advisory feed.

In short

  • Packagist proxy for composer install and update
  • Each release's exact commit fetched once, scanned and kept
  • Git source removed, so composer cannot go round the box
  • Rules on vendor/name or symfony/*
  • Advisories from OSV's Packagist feed
  • Tagged releases only, branches are not served

In the documentation

Goes well with

  • Check, walk and review See what the rules say before you install. Walk a dependency tree. Review a lockfile or an SBOM.
  • RubyGems mirror Bundler and gem install through the compact index, with every .gem checked against its sha256.
  • 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.