declarative-cachix

KO | EN

gitlite — search

#php #dotfiles #ios #swift #database #react #python #macos #golang #api #hacktoberfest #atom

declarative-cachix

★ 36 Open GitHub ↗

Manage cachix caches declaratively

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Declarative Cachix

Add [cachix](https://cachix.org/) caches declaratively.
You can use it either as a system module, or as a home-manager module.

### System module

Import `default.nix` into your system configuration.
This adds the top-level `cachix` option, which you can use to add cachix caches.
You can either pass them as names, or as `{name, sha256}` attribute pairs.

Example configuration:
```nix
  {
    imports = [
      (import (builtins.fetchTarball "https://github.com/jonascarpay/declarative-cachix/archive/a2aead56e21e81e3eda1dc58ac2d5e1dc4bf05d7.tar.gz"))
    ];

cachix = [
      { name = "jmc"; sha256 = "1bk08lvxi41ppvry72y1b9fi7bb6qvsw6bn1ifzsn46s3j0idq0a"; }
      "iohk"
    ];
  }
```

### Home-manager module

#### Usage

Import `home-manager.nix` into your home-manager configuration.
This adds two user-facing options; `caches.extraCaches` and `caches.cachix`.

Note that you need to be a trusted user to be able to specify caches.
See [this issue](https://github.com/jonascarpay/declarative-cachix/issues/2) for more information.

Example configuration:
```nix
  {
    imports = [
      (
        let
          declCachix = builtins.fetchTarball "https://github.com/jonascarpay/declarative-cachix/archive/a2aead56e21e81e3eda1dc58ac2d5e1dc4bf05d7.tar.gz";
        in import "${declCachix}/home-manager.nix"
      )
    ];

caches.cachix = [
      { name = "jmc"; sha256 = "1bk08lvxi41ppvry72y1b9fi7bb6qvsw6bn1ifzsn46s3j0idq0a"; }
      "nix-community"
    ];

caches.extraCaches = [
      {
        url = "https://hydra.iohk.io";
        key = "hydra.iohk.io:********************************************";
      }
    ];
  }
```

#### Experimental

There is a `home-manager-experimental.nix` module that uses the `extra-substituters` and `extra-trusted-public-keys` configuration fields, instead of the normal `substituters` and `trusted-public-keys`.
These fields compose better and have less risk of accidentally overriding other configuration, but unfortunately they are not yet available in stable nix.

If you're on unstable and have enabled experimental features, and you're having issues where your caches are not properly being picked up, consider switching to this module.
It takes the same options as the normal module.

declarative-cachix

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README