Skip to content

A sane, batteries-included starter template for running NixOS on Multiple Machines

Notifications You must be signed in to change notification settings

LGUG2Z/nixos-multi-machine-starter

Repository files navigation

nixos-multi-machine-starter

This repository is intended to be a sane, batteries-included starter template for running a LunarVim-powered NixOS development environment on both WSL and on Hetzner Cloud.

This repository is the result of a live refactoring session where I demonstrated how to merge two NixOS configurations for separate machines and machine types into a single flake.

If you found this starter template useful, please consider sponsoring and subscribing to my YouTube channel.

What Is Included

This starter is a lightly-opinionated take on a productive terminal-driven development environment based on my own preferences. However, it is trivial to customize to your liking both by removing and adding tools that you prefer.

  • The default editor is initially lvim
  • win32yank is used to ensure perfect bi-directional copying and pasting to and from Windows GUI applications and LunarVim running in WSL
  • The default shell is zsh
  • Native docker (ie. Linux, not Windows) is enabled by default
  • The prompt is Starship
  • fzf, lsd, zoxide, and broot are integrated into zsh by default
    • These can all be disabled easily by setting enable = false in home.nix, or just removing the lines all together
  • direnv is integrated into zsh by default
  • git config is generated in home.nix with options provided to enable private HTTPS clones with secret tokens
  • zsh config is generated in home.nix and includes git aliases, useful WSL aliases, and sensible$WORDCHARS

Quickstart

Watch the walkthrough video

You should follow the quickstart steps from either nixos-wsl-starter or nixos-hetzner-cloud-starter depending on if you are targeting the WSL VM configuration or the Hetzner Cloud VM configuration.

About

A sane, batteries-included starter template for running NixOS on Multiple Machines

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages