mducoli / kawari-nix

Home manager module to fill templates from env files

kawari-nix

Home manager module to embed variables (usually secrets) into a text file for configuration.

This project was made because sops-nix doesn't support template files when used as a home manager module

At home manager activation the templates are filled and the resulting files are stored in $XDG_RUNTIME_DIR/kawari-nix/secrets and linked where you need them.

Installation

Add kawari-nix to your flake inputs:

{
  inputs = {
    # ...
    kawari-nix.url = "github:mducoli/kawari-nix";
  };
}

Import the home-manager module

{
  # NixOS system-wide home-manager configuration
  home-manager.sharedModules = [
    inputs.kawari-nix.homeManagerModule
  ];
}

{
  # Configuration via home.nix
  imports = [
    inputs.kawari-nix.homeManagerModule
  ];
}

Usage

Here is an example usage with sops-nix

kawari.template."example-app" = {
  content = /* toml */ ''
    password = "@PASSWORD@"
  '';
  envFile = config.sops.secrets.your-secret.path; # env file, example: PASSWORD=your-password
  path = "${config.xdg.configHome}/kawari-nix/secrets/example-app"; # this is the default value, you can change this if you want to link the resulting file on another location
  linkTo = []; # or you can specify other locations to link to
};

Configuration

You can change the default directory of the links

kawari.defaultPath = "${config.xdg.configHome}/kawari-nix" # default value