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
  1. Home
  2. Documentation
  3. Developer Guide
  4. Set up apt

Linux packages (apt)

Set up apt

Point apt at a ForgeRepo™ mirror of Debian or Ubuntu, and give it your token.

Your admin tells you the mirror address. Put it in your sources in place of the distro's own, and your login in /etc/apt/auth.conf.d/:

Set up apt to use ForgeRepo™
$ cat /etc/apt/sources.list
deb https://packages.example.com/apt/debian/ bookworm main
$ cat /etc/apt/auth.conf.d/company.conf
machine packages.example.com/apt/ login your-user-name password <your token>
$ apt-get update
Get:1 https://packages.example.com/apt/debian bookworm InRelease [151 kB]
Get:2 https://packages.example.com/apt/debian bookworm/main amd64 Packages [8790 kB]
Fetched 8941 kB in 2s (5825 kB/s)
Reading package lists...

Captured by running these commands against a real ForgeRepo™.

  • apt still checks the distro's signature on the index, so nothing changes about trust.
  • Make the auth file readable only by root: chmod 600, since it holds your token.
  • Remove the distro's own sources, so every package comes through packages.example.com.
  • A bare Debian or Ubuntu image has no CA certificates, so apt can not reach an https mirror. Install ca-certificates in your base image, or point Acquire::https::CAInfo at your company CA.

Then install as usual:

Install packages
$ apt-get install -y tree
...
0 upgraded, 1 newly installed, 0 to remove and 0 not upgraded.
Need to get 52.5 kB of archives.
After this operation, 116 kB of additional disk space will be used.
Get:1 https://packages.example.com/apt/debian bookworm/main amd64 tree amd64 2.1.0-1 [52.5 kB]
Fetched 52.5 kB in 1s (40.1 kB/s)
Preparing to unpack .../tree_2.1.0-1_amd64.deb ...
Unpacking tree (2.1.0-1) ...
Setting up tree (2.1.0-1) ...

Captured by running these commands against a real ForgeRepo™.

Note

If your admin set the mirror to a filtered index, it is signed by ForgeRepo™ instead of the distro. Fetch the key from https://packages.example.com/apt/signing-key.asc into /etc/apt/keyrings/ and add [signed-by=/etc/apt/keyrings/forgerepo.asc] to the line.