flux bootstrap supports sparse checkout
Introduced 2026-06-30 · score 0.97
HOW TO USE IT
When bootstrapping Flux from a monorepo, pass `--sparse-checkout` with comma-separated directories and include the directory given to `--path`.
flux bootstrap github --owner=<owner> --repository=<repository> --path=<path> --sparse-checkout=<path>,<directory>WHY THIS HELPS
Bootstrap Flux from a large monorepo while limiting the directories checked out by Flux.
REQUIREMENTS AND LIMITATIONS
- Version: v2.9.0
- --sparse-checkout: Comma-separated directories included in the GitRepository sparse checkout; the configured `--path` must be one of them.
- --path (required): Bootstrap target path; include it in `--sparse-checkout`.
- --owner (required): GitHub repository owner.
- --repository (required): GitHub repository name.
- The `--path` directory must be included in the `--sparse-checkout` list.
- The flag applies to the `github`, `gitlab`, `gitea`, `git`, and `bitbucket-server` bootstrap providers.
FIRST-PARTY EVIDENCE
- https://github.com/fluxcd/flux2/releases/tag/v2.9.0
- https://github.com/fluxcd/flux2/pull/5918
- https://v2-9.docs.fluxcd.io/flux/cmd/flux_bootstrap/
- https://v2-9.docs.fluxcd.io/flux/cmd/flux_bootstrap_github/
Check the installed version and the source before using it. Entry JSON