Welcome to Cachix documentation

Cachix is a service for Nix binary cache hosting.

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

Topics

• Installation
  • Recommended
  • Flakes
  • Using Nixpkgs or NixOS
• Getting Started
  • Creating the cache
  • Authenticating
  • Signing key (advanced mode)
  • 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
• Importing from S3
  • Overview
  • Prerequisites
  • Importing Cache from S3
    • Step 1: Configure AWS Credentials
    • Step 2: Cachix Installation
    • Step 3: Start the Import Process
  • Important Notes
• Cachix Deploy
  • Running an agent
    • Prerequisites
    • Create a binary cache
    • Create a workspace
    • Generate agent token
    • Starting an agent
  • Deploying to agents
    • Prerequisites
    • Get Deploy Activate Auth Token
    • Write Deploy specification
    • Activate the deployment
  • Troubleshooting
    • Changing agent name
  • Reference
    • deploy.json
• 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
• Pins
  • Overview
  • How to Create a Pin
  • Controlling Retention with Pins
  • Exposing Files with Artifacts
  • Examples
• Security
  • Login using GitHub
  • Secrets
  • Binary Caches
• Enterprise
  • Telemetry
    • Span attributes
• 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
  • warning: ‘https://mycache.cachix.org’ does not appear to be a binary cache
  • How can I check if my auth token works?
• Glossary