> For the complete documentation index, see [llms.txt](https://stablebuild.gitbook.io/stablebuild-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stablebuild.gitbook.io/stablebuild-docs/readme.md).

# StableBuild docs

Welcome to StableBuild! We help developers create reliable and deterministic builds - by letting you easily freeze and pin Docker images, operating system packages, Python packages, and arbitrary build dependencies. You integrate StableBuild into your existing builds in <5 lines of code, and will never have to worry about package updates randomly breaking your builds again.

**Getting started**

* If you're unsure why you need to pin *all* your dependencies, read our StableBuild primer: [Why StableBuild?](/stablebuild-docs/why-stablebuild.md).
* Then, run through the tutorial: [Pinning your first container with StableBuild](/stablebuild-docs/pinning-your-first-container.md).

**Mirrors and caches**

* [OS package registry](/stablebuild-docs/mirrors-and-caches/os-package-registry-ubuntu-debian-alpine.md) - Pin all your Ubuntu, Debian and Alpine packages to a specific date.
* [Docker mirror](/stablebuild-docs/mirrors-and-caches/docker-mirror.md) - Cache containers, make any container immutable, and pull without rate limits.
* [PyPI mirror](/stablebuild-docs/mirrors-and-caches/pypi-mirror.md) - Pin your Python packages to a specific date with pip, Poetry or uv.
* [HuggingFace mirror](/stablebuild-docs/mirrors-and-caches/huggingface-mirror.md) - Cache HuggingFace models, and make any model immutable.
* [File mirror](/stablebuild-docs/mirrors-and-caches/file-mirror.md) - Make URLs immutable and store arbitrary build dependencies.

**Product docs**

* [Setting up single sign-on (SSO)](/stablebuild-docs/product/single-sign-on-saml.md) - incl. tutorials for Google Workspace and Okta.
* [Software Bill of Materials (SBOM)](/stablebuild-docs/product/sbom.md) - generate a CycloneDX SBOM of everything a build fetched through StableBuild.
* [Billing](/stablebuild-docs/product/billing.md) - detailed descriptions on how we charge for traffic and storage.

**Tutorials**

* [Protecting your keys in public Docker containers](/stablebuild-docs/tutorials/protecting-your-keys-in-public-docker-containers.md) - must-read if you plan to publish containers built with StableBuild to Docker Hub or other public registries.

For support or billing questions, please reach out to <support@stablebuild.com>.