Cachix Deploy

Note

Cachix Deploy is in public beta. This means you won’t be charged, as we are gathering feedback.

Cachix Deploy provides continuous deployments to a Nix profile (like NixOS, nix-darwin or Home Manager) using a pull model.

It consists of running a simple daemon process cachix deploy agent myagent that connects to our backend using websockets and waits for a new deployment. There’s no Nix evaluation or building done on the agent. The agent pulls all binaries from your binary cache and activates the new deployment.

To start new deployments you run cachix deploy activate <deploy.json> with a specification of what each agent should deploy.

See an example of how we deploy our self-managed CI workers.

• 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