Experimental NixOS repo
Find a file
2021-02-17 14:38:37 -07:00
.github github: default labels for issue templates 2021-02-17 14:38:37 -07:00
cachix doc: new mdbook documentation 2021-02-14 02:46:05 -07:00
compat flake: manage flake-compate as input 2021-02-14 22:08:24 -07:00
doc nix: fix #126 2021-02-17 14:15:43 -07:00
extern deploy-rs: init support 2021-02-14 22:17:24 -07:00
hosts doc: finish flk reference 2021-02-14 17:41:15 -07:00
lib deploy: move logic to lib 2021-02-15 11:24:43 -07:00
modules doc: new mdbook documentation 2021-02-14 02:46:05 -07:00
nix checks: add checks to ci 2021-02-14 22:33:37 -07:00
overlays nix: fix #126 2021-02-17 14:15:43 -07:00
overrides nix: fix #126 2021-02-17 14:15:43 -07:00
pkgs nix: patch nix directly for experimental features 2021-02-17 12:54:41 -07:00
profiles nix: patch nix directly for experimental features 2021-02-17 12:54:41 -07:00
secrets doc: new mdbook documentation 2021-02-14 02:46:05 -07:00
shell nix: patch nix directly for experimental features 2021-02-17 12:54:41 -07:00
suites doc: new mdbook documentation 2021-02-14 02:46:05 -07:00
theme doc: finish flk reference 2021-02-14 17:41:15 -07:00
users doc: new mdbook documentation 2021-02-14 02:46:05 -07:00
.editorconfig editorconfig: fixup 2020-12-30 01:00:12 -07:00
.envrc compat: fixes 2021-01-23 16:45:10 -07:00
.gitignore doc: new mdbook documentation 2021-02-14 02:46:05 -07:00
book.toml doc: new mdbook documentation 2021-02-14 02:46:05 -07:00
cachix.nix format: apply nixpkgs-fmt 2020-07-30 22:17:28 -06:00
COPYING init 2019-12-02 22:18:30 -07:00
default.nix shell: workaround https://github.com/NixOS/nix/issues/4529 2021-02-06 13:27:26 -07:00
flake.lock shell: use devshell.toml 2021-02-17 11:49:13 -07:00
flake.nix deploy: move logic to lib 2021-02-15 11:24:43 -07:00
README.md README.md: add shields and useful links 2021-02-15 00:41:45 -07:00
shell.nix compat: fixes 2021-01-23 16:45:10 -07:00
SUMMARY.md doc: usage for deploy-rs 2021-02-15 11:08:17 -07:00

Build MIT License NixOS 20.09

Introduction

Nixflk is a template which grants a simple way to use, deploy and manage NixOS systems for personal and productive use. It does this by providing a sane repository structure, integrating several popular projects like home-manager, setting clear guidelines, offering useful conveniences, and eliminating boilerplate so you can focus on deploying your systems.

Getting Started

Check out the guide to get up and running.

Motivation

NixOS provides an amazing abstraction to manage our computers, but that new power can sometimes bring feelings of overwhelm and confusion. Having a turing complete programming language can add an unlimited potential for complexity if we do it wrong. Instead, we should have a community consensus on how to manage a NixOS system — consider this a first attempt.

The future is declarative! 🎉

Community Profiles

There are two branches from which to choose: core and community. The community branch builds on core and includes several ready-made profiles for discretionary use.

Every package and NixOS profile declared in community is uploaded to cachix, so everything provided is available without building anything. This is especially useful for the packages that are overridden from master, as without the cache, rebuilds are quite frequent.

⚠ Advisory ⚠

Nixflk leverages the flakes feature available via an experimental branch of nix. Until nix 3.0 is released, this project should be considered unstable.

Inspiration & Art

License

Nixflk is licensed under the MIT License.