{"id":16343279,"url":"https://github.com/ners/nixos","last_synced_at":"2025-10-26T00:31:14.501Z","repository":{"id":40594728,"uuid":"188591817","full_name":"ners/NixOS","owner":"ners","description":"A feature-rich NixOS configuration that can double as a learning resource.","archived":true,"fork":false,"pushed_at":"2023-08-22T09:38:05.000Z","size":1241,"stargazers_count":33,"open_issues_count":0,"forks_count":3,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-10-12T00:24:04.140Z","etag":null,"topics":["nix","nixos-configuration","nixos-dotfiles"],"latest_commit_sha":null,"homepage":"","language":"Nix","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ners.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-05-25T16:59:53.000Z","updated_at":"2024-09-26T19:50:46.000Z","dependencies_parsed_at":"2023-02-17T04:46:13.452Z","dependency_job_id":null,"html_url":"https://github.com/ners/NixOS","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ners%2FNixOS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ners%2FNixOS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ners%2FNixOS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ners%2FNixOS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ners","download_url":"https://codeload.github.com/ners/NixOS/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238235632,"owners_count":19438725,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["nix","nixos-configuration","nixos-dotfiles"],"created_at":"2024-10-11T00:24:01.091Z","updated_at":"2025-10-26T00:31:13.897Z","avatar_url":"https://github.com/ners.png","language":"Nix","funding_links":[],"categories":[],"sub_categories":[],"readme":"# A Somewhat Attractive NixOS Configuration\n\n\u003cimg src=\"https://raw.githubusercontent.com/NixOS/nixos-artwork/master/logo/nix-snowflake.svg\" align=\"right\" alt=\"Nix logo\" width=\"150\"\u003e\n\n\u003e This is my Nix flake. There are many like it, but this one is mine.\n\u003e\n\u003e My Nix flake is my best friend. It is my life. I must master it as I must master my life.\n\u003e\n\u003e Without me, my Nix flake is useless. Without my Nix flake, I am useless. I must configure my Nix flake true. I must build more reproducibly than my computer who is trying to deceive me. I must configure it before it deceives me. I will ...\n\u003e\n\u003e My Nix flake and I know that what counts in IT is not the amount of words we type, the noise of our keyboard, nor the outputs we make. We know that it is the derivations that count. We will derive ...\n\u003e\n\u003e My Nix flake is human, even as I am human, because it is my life. Thus, I will learn it as a brother. I will learn its weaknesses, its strength, its code, its tooling, its inputs and outputs. I will keep my Nix flake clean and ready, even as I am clean and ready. We will become part of each other. We will ...\n\u003e\n\u003e Before God, I swear this creed. My Nix flake and I are the defenders of reliability. We are the masters of reproducibility. We are the saviors of my life.\n\u003e\n\u003e So be it, until victory is reproducible and there is no uncertainty, but peace!\n\u003e\n\u003e — NixOS User's Creed\n\n## Overview\n\nThis repository contains configuration files that can be used to build a [NixOS][nixos] image, or to configure [Nix on other Linux distributions][nix-on-linux] (including [WSL][nix-on-wsl]) by using [home-manager][home-manager].\n\n## Who is this for?\n\nThe primary purpose of this repository is to [Just Work™][just-work] as a configuration for [my][ners] [devices][configurations].\n\nHowever, the repository is also intended as a model of a fully-featured NixOS configuration.\nAs such it can be used as a reference or starting point for others interested in Nix and NixOS.\n\n## Design goals\n\nThe following goals are the driving force of this repository:\n\n### Easy to study and extend\n\nThe configurations provided by this repository are opinionated, and are indeed only guaranteed to work for me.\nHowever, they should provide a good starting point for those seeking to strengthen their Nix-fu, as well as a base on top of which one can easily create derivative configurations, even with little Nix knowledge.\nIf nothing else, I rely on this feature when creating new configurations for myself.\n - Separation of concerns makes it easy to enable features, either shared across configurations, or specific to a configuration.\n - There should be as few sources of truth as possible; e.g. the [latest NixOS version], while referenced in multiple places, is only specified [once][nixos-version-defined].\n - Care has gone into organising and documenting the repository. Eventually all non-trivial decisions should be documented and justified.\n\n### Good desktop experience\n\nThe Linux Desktop has in many ways surpassed other desktop offerings in both form and function.\nA good distribution should delight its users from first boot.\n\nThis largely comes down to choosing sensible defaults:\n - The GNOME desktop environment has rightfully become the de facto standard of modern Linux Desktop. It is mature, feature-complete, and polished to a shine even out of the box.\n - Wayland and Pipewire are modern standards for video and audio respectively.\n - The keyboard layout of choice should be set up in both console and graphical environments.\n - The shell/terminal setup should be delightful rather than boring and plain, and should not break POSIX compatilibity.\n - Reasonably useful utilities such as virtualisation managers, e-mail clients, and office applications, should come out of the box; the ease of doing so is the largest victory of modern Linux desktop.\n - When running as a virtualised guest, it should be easy to configure guest tools and agents for improved integration with the host; e.g. the [ISO image][iso-image] is one such configuration.\n\n### Easy server setup\n\nIn addition to desktop configurations, this repository should also make it easy to specify server configurations.\nMany of these goals also benefit the desktop experience:\n - Full-disk encryption should be an easy default.\n - Modern filesystems (e.g. [btrfs][btrfs]) add features such as subvolumes, snapshotting, transparent compression, and many more. These should be used to their full potential.\n - systemd and NetworkManager should be leveraged to their full extent.\n\n### Easy to install and maintain\n\nAfter test-driving the live environment, installing it to persistent storage should be as painless as possible.\n\nNixOS has no canonical guided installation yet, so this repository provides [an opinionated one][installation-wizard].\n\nThere is also [a utility][update-wizard] for updating the system.\n\n## Getting started\n\nWIP\n\n[btrfs]: https://btrfs.wiki.kernel.org\n[configurations]: /configurations\n[home-manager]: https://github.com/nix-community/home-manager\n[installation-wizard]: /overlays/pkgs/nixos-wizard/wizard.sh\n[iso-image]: /configurations/iso-image/default.nix\n[just-work]: https://youtu.be/CZFKWt3S2Ys\n[ners]: https://github.com/ners\n[nix-on-linux]: https://nixos.org/download.html#nix-install-linux\n[nix-on-wsl]: https://nixos.wiki/wiki/Nix_Installation_Guide#Windows_Subsystem_for_Linux_.28WSL.29\n[nixos-version-defined]: /flake.nix#L3\n[nixos]: https://nixos.org\n[update-wizard]: /overlays/pkgs/nixos-update/nixos-update.sh\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fners%2Fnixos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fners%2Fnixos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fners%2Fnixos/lists"}