# 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>.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://stablebuild.gitbook.io/en/stablebuild-docs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.