Nix starter kit

Provisioning a fresh system

• Install the Nix package manager and enable Flakes
• FIXME: bootstrapping!
• On the target system, use the provided template to create an initial home-manager configuration with batteries included:

mkdir -p ~/.config
nix flake new --template github:active-group/nix-starter-kit ~/.config/home-manager

• To configure “modules” like Emacs, zsh, or others, check the README files in their respective subdirectories in this repository
• For new people: Create or add an SSH key pair and make sure access to our GitLab is working. If you already have one set up, there is nothing for you to do.
• If you wish to use LaTeX with batteries included, then you need to clone the howto repository to ~/howto (or configure the path in your home.nix according to your checkout path). If you already have a working LaTeX setup, you don’t need to change anything.

Usage

Adding software

On https://search.nixos.org/packages you can search for packages you’d like to have available on your system. Add those packages to your home.nix in home.packages. Check out the home-manager manual or ask someone if in trouble :)

To “activate” a new configuration, always execute

home-manager switch

Out-of-office notifications via sieve-connect (FIXME)

The file message.template contains a template for the message you wish to be shown. Create a copy of this file named message:

cp ./sieve/message.template ./sieve/message

Now edit it according to your preferences and personal details. To then activate the notification, execute

./sieve/sieve.sh activate

Note: you will be asked for you IMAP/Sieve username (only) on first use. This is your mail address, not your LDAP user name.

To deactivate the notifications, execute

./sieve/sieve.sh deactivate

Keeping things up to date

When asked to update your configuration (usually when something has changed in the starter kit), do the following:

cd ~/.config/home-manager
nix flake update
home-manager switch

See the note on updating the Mac trampolines in README for mac-app-util.

If you see errors related to “sandbox initialization”, you might need to turn off sandboxing temporarily in /etc/nix/nix.conf.

Updating Nixpkgs (for admins)

Check:

https://github.com/NixOS/nixpkgs/branches

Go to the desired release branch. If you change the release channel, update the stateVersion attribute in the template.