Guide · Supply-chain security · as of 29 October 2026

GitHub’s npm package firewall, explained

On 20 October 2026 GitHub put a firewall between your machines and the npm registry. It checks each package before it is installed, and blocks the ones that break a policy you set. Here is what it does, who can use it, what it will cost, and the one way teams get it wrong, from GitHub’s own announcement.

What it is

A checkpoint between your code and npm.

The package firewall sits between your endpoints, or an internal registry, and the upstream package repositories. Every request passes through it before anything is downloaded. It inspects both the metadata requests and the package downloads for signs of malicious activity, and refuses the ones that fail your policy. Nothing reaches a developer’s laptop, a CI runner or an AI coding agent until it has passed.

Who can use it, and what it costs

Public preview, Enterprise Cloud, npm only.

  • Available now in public preview to all GitHub Enterprise Cloud customers, including data-resident Enterprise Cloud.
  • Free during the preview. At general availability it will be charged on metered usage, similar to how Actions is billed.
  • npm only for now. pip, Maven, NuGet and the other ecosystems are not covered yet.
  • It protects the places packages are pulled: CI/CD runners, developer machines and AI coding agents.

The policy controls available today

You set the rules; the firewall enforces them.

A configurable cooldown period: hold back a version for a set time after it is published, so a package that is poisoned and pulled within hours never reaches you. Checks against the GitHub Advisory Database for malware and known-vulnerability advisories, so a flagged package is stopped at the door. Supply-chain integrity checks such as attestation downgrades, where a package that used to ship signed provenance suddenly arrives without it. The firewall is only as strong as its policy. An administrator sets these at the enterprise level before it blocks anything.

When it blocks the wrong thing

A legitimate package can be let through.

A cooldown or a false positive will sometimes stop a package your build genuinely needs. When that happens the developer requests an exception, through a workflow like the ones other GitHub Advanced Security features use, and an administrator approves it. That is the trade: a short delay and the odd exception, in return for never installing the malware the delay was built to catch.

The one way teams get it wrong

A firewall routed around is no firewall.

It only protects the requests that go through it. Endpoints have to be configured to use the firewall instead of pointing straight at the public registry. The usual leaks: a scoped registry line in a committed .npmrc, a resolved URL baked into a lock file that downloads from somewhere else, or a runner that can still reach registry.npmjs.org directly. Close them, restrict what your runners can reach on the network, and confirm installs actually pass through the firewall.

Why GitHub built it now

A year of worms and stolen tokens.

The firewall is a direct answer to 2025 and 2026: the self-replicating Shai-Hulud worm, and the GhostAction campaign that swept malicious workflows through tens of thousands of repositories the day before this launched. The damage is done at install time, by code that runs before you ever use the package.

The npm attacks behind the firewall

Where to go next

Set it up, or weigh the alternatives.

  • Hardening an npm CI/CD pipeline: the install-time settings that work with or without this firewall.
  • npm package firewall alternatives: Socket, Aikido Safe Chain, Datadog SCFW and the free native controls.
  • The npm attacks behind the firewall: what Shai-Hulud and GhostAction actually did.

Why this matters to us

We build agents that install packages.

We are an AI lab in Dubai. The AI coding agents and business apps we build pull from npm every day, which is exactly the surface this firewall guards. We treat a dependency as untrusted until a cooldown, a lock file and a policy say otherwise.

AI agents, built in Dubai

Sources

read 29 October 2026

Check it at the source.

  1. GitHub Changelog — package firewall in public preview — the announcement, 20 October 2026
  2. GitHub Docs — protecting endpoints with package firewall — the setup steps
  3. GitHub community discussion — package firewall — questions and limitations

A question?

Pull a lot from npm?

Tell us how your team ships, and we will tell you honestly where a dependency could bite it.

Talk to usWhatsApp +971 50 728 5494hello@brevdigital.com