Welcome to Cachix documentation

Cachix is a service for Nix binary cache hosting.

You’ll never again waste building anything twice and saving time on your CI.

You’ll build and cache developer environments for every project on every branch.

Feedback can be reported via a public github issue, support chat on app.cachix.org or at support@cachix.org.

Topics

• Installation
  • Recommended
  • Using Nixpkgs or NixOS
• Getting Started
  • Creating the cache
  • Authenticating
  • Signing key (optional)
  • Pushing binaries with Cachix
  • Using binaries with Nix
• Getting Started With Continuous Integration
  • GitHub Actions (recommended)
  • Buildkite
  • CircleCI
  • GitLab CI
  • Hercules CI
  • Hydra
  • Travis CI
• Pushing to Cachix
  • Pushing runtime dependencies
  • Pushing build and runtime dependencies
  • Pushing shell environment
  • Pushing whole /nix/store
  • Pushing all newly built store paths
  • Push all store paths produced during a command
  • Flakes
    • Pushing flake inputs
    • Pushing runtime closure
    • Pushing shell environment
• Garbage Collection
  • Deletion algorithm
• Security
  • Login using GitHub
  • Secrets
  • Binary Caches
• Frequently Asked Questions
  • What Nix versions are supported?
  • Does pushing a store path override an existing entry?
  • Are entries immediately available after they are pushed?
  • Why is Nix not picking up on any of the pre-built artifacts?
  • Is there a way to cache nix-shell?
  • How to disable binary caches when working offline?
  • What happens when I run cachix use (both immediately and any stateful effects for the future)?
  • I get InvalidPath error from Nix when invoking Cachix
• Glossary