How-tos

Task-oriented guides for common workflows and customization scenarios.

Popular Guides

Quick links to frequently used guides:

• Using Build Containers - Running fromager in containers (recommended approach)

• Using Constraints to Build Collections - Pin versions for reproducible builds

• Understanding Why a Package is in the Graph - Debug unexpected dependencies

• Enable Repeatable Builds - Ensure build reproducibility

Getting Started

Essential guides for initial setup and first builds.

• Authentication
• Using Build Containers
• Using Constraints to Build Collections

Building Packages

Guides for building packages from various sources and configurations.

• Building from a Git Repository
• Enable Repeatable Builds
• Run parallel jobs, allocate cpu cores per job and allocate memory per job
• Using an External Build Web Server

Build Configuration

Customize builds with overrides, variants, and version handling.

• Working with Complex pyproject.toml Requirements
• Build Collections with Multiple Versions of the Same Package
• Multiple Version Bootstrap
• Building Pre-release Versions
• Protect Against Supply-Chain Attacks with Release-Age Cooldown

Analyzing Builds

Understand and debug dependency graphs and build issues.

• Graph Command Examples

See Also

• Customizing parts of the package build process - Comprehensive guide to customization options

• Configuration Reference - Configuration reference

• Fromager hooks and override plugins - Override plugins and hooks