> For the complete documentation index, see [llms.txt](https://stablebuild.gitbook.io/en/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/en/stablebuild-docs.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?](/en/why-stablebuild.md).
* Then, run through the tutorial: [Pinning your first container with StableBuild](/en/pinning-your-first-container.md).

**Mirrors and caches**

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

**Product docs**

* [Setting up single sign-on (SSO)](/en/product/single-sign-on-saml.md) - incl. tutorials for Google Workspace and Okta.
* [Billing](/en/product/billing.md) - detailed descriptions on how we charge for traffic and storage.

**Tutorials**

* [Protecting your keys in public Docker containers](/en/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>.
