Skip to content
armbianPublic

About

Automatic backport service for Linux kernel security fixes in Armbian. It gathers CVE records, finds the fixes that the stable branches 6.1, 6.12, 6.18 and 7.3 do not have yet, and verifies that each patch applies and builds. Claude Code backports the fixes that do not apply cleanly, and a human reviews each backport.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

1 watching

Forks

Repository files navigation

Armbian logo

Armbian Kernel Security Fixes

Purpose of This Repository

An automatic backporting service for kernel security fixes. It targets the older LTS kernels 6.18, 6.12 and 6.1, and the newest stable, 7.3 — closing the gap between the moment a CVE is public and the moment a stable point release carries the fix.

How it works

patches/<series>/ holds every known fix that the stable branch does not have yet:

  • Each fix applies cleanly on the stable head, and the whole set builds.
  • A fix that does not apply is backported with Claude Code. A human reviews the backport in cve/<CVE>/<series>/.
  • A fix leaves the folder the moment the stable branch carries it (either the CVE record declares a fixed-in version at or below the head, or the patch reverse-applies on the head).

Nothing accumulates: patches/ is rebuilt from scratch on every run.

Usage

Apply the patches in series.conf order on the commit in base.

Check whether a CVE is covered, and if not, why:

./fasttrack.sh why CVE-2026-1234

It needs no sync; without a local CVE feed it reads the record from CVE.org.

Other commands

./fasttrack.sh sync                         # pull kernel + CVE sources
./fasttrack.sh run                          # gather + verify; writes patches/ and report.md
./fasttrack.sh cve CVE-2026-1234            # resolve a specific incident
./fasttrack.sh cve --unpatched --claude     # backport every open issue with Claude

See ./fasttrack.sh --help for all options.

Repository layout

Path Contents
patches/<series>/ Verified fixes for a kernel series: series.conf, base, numbered .patch files and fasttrack.json provenance
cve/<CVE>/<series>/ Reviewed per-incident backports (same layout), included into patches/ on the next run
fasttrack/ The Python backport tool (python3 -m fasttrack.cli)
scripts/ Helper scripts, including build-test.sh used by CI
tests/ Unit tests for the fasttrack tool
docs/ Documentation assets
fasttrack.sh Thin wrapper that runs python3 -m fasttrack.cli
report.md Latest gather-and-verify report, per series
cve-report.md Latest per-incident resolution report
unpatched.json, cves.json, attempts.json Machine-readable state consumed by the tool

Requirements

For contributors running the tool locally:

  • Linux with about 10 GB of free disk space
  • Python 3 with PyYAML
  • Kernel build tools (Debian/Ubuntu: build-essential bc bison flex libelf-dev libssl-dev dwarves)
  • Claude Code on PATH, if you want to produce backports

The tool itself is written in Python 3; the convenience wrapper fasttrack.sh and scripts/build-test.sh are Bash. CI workflows are GitHub Actions YAML.

Continuous integration

A scheduled job (every 15 minutes) pulls fresh upstream data, gathers and verifies patches, and commits changes back to main. On-demand runs let Claude Code backport specific CVEs and open a pull request. Every patch series is compile-tested on arm64, arm, riscv and x86 with allmodconfig.

For the live status of all workflows in this repository, see the Armbian CI overview:

https://actions.armbian.com/?repo=cve

Contributing

You can help backport fixes that do not apply cleanly by running Claude Code against open CVEs. The short way is:

git clone https://github.com/armbian/cve.git
cd cve
claude
> /contribute

Full instructions, including the by-hand workflow, are in CONTRIBUTING.md. Internals of the fasttrack tool are documented in DEVELOPMENT.md.

More

About

Automatic backport service for Linux kernel security fixes in Armbian. It gathers CVE records, finds the fixes that the stable branches 6.1, 6.12, 6.18 and 7.3 do not have yet, and verifies that each patch applies and builds. Claude Code backports the fixes that do not apply cleanly, and a human reviews each backport.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages