203 lines
7.7 KiB
Markdown
203 lines
7.7 KiB
Markdown
```
|
|
██████ █████ ███████ ██ ██ ███ ██ ██ ██ ██
|
|
██ ██ ██ ██ ██ ██ ██ ████ ██ ██ ██ ██
|
|
██ ██ ███████ ███████ ███████ ██ ██ ██ ██ ███
|
|
██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██
|
|
██████ ██ ██ ███████ ██ ██ ██ ████ ██ ██ ██
|
|
```
|
|
|
|
A very opinionated (technically only for me) configuration that allows easy adding and removing of systems alongside custom configurations for each system.
|
|
|
|
# Usage
|
|
|
|
This flake is intended to be used as an input to your own NixOS configuration:
|
|
|
|
```nix
|
|
dashNix = {
|
|
url = "github:DashieTM/DashNix";
|
|
inputs = {
|
|
# ensure these are here to update the packages on your own
|
|
nixpkgs.follows = "nixpkgs";
|
|
stable.follows = "stable";
|
|
};
|
|
};
|
|
```
|
|
|
|
You can then configure your systems in your flake outputs with a provided library command:
|
|
|
|
```nix
|
|
nixosConfigurations = inputs.dashNix.dashNixLib.build_systems ./.;
|
|
```
|
|
|
|
This command will build each system that is placed within the hosts/ directory.
|
|
In this directory create one directory for each system you want to configure with DashNix.
|
|
This will automatically pick up the hostname for the system and look for 3 different files that are explained below.
|
|
(Optionally, you can also change the parameter root (./.) to define a different starting directory than hosts/)
|
|
|
|
In order for your configuration to work, you are required to at least provide a single config file with a further config file being optional for custom configuration.
|
|
The hardware.nix specifies additional NixOS configuration, while home.nix specifies additional home-manager configuration. (both optional)
|
|
|
|
|- flake.nix\
|
|
|- flake.lock\
|
|
|- hosts/\
|
|
|--- system1/\
|
|
|------ configuration.nix (required)\
|
|
|------ hardware.nix (optional)\
|
|
|------ home.nix (optional)\
|
|
|--- system2/\
|
|
|------ configuration.nix (required)\
|
|
|------ hardware.nix (optional)\
|
|
|------ home.nix (optional)\
|
|
|--- system3/\
|
|
|------ configuration.nix (required)\
|
|
|------ hardware.nix (optional)\
|
|
|------ home.nix (optional)
|
|
|
|
Here is a minimal required configuration.nix (the TODOs mention a required change):
|
|
|
|
```nix
|
|
{config, ...}: {
|
|
# variables for system
|
|
# TODO important changes
|
|
conf = {
|
|
# change this to your monitor and your pc name
|
|
# should be something like DP-1
|
|
defaultMonitor = "YOURMONITOR";
|
|
# width x height @ refreshrate
|
|
defaultMonitorMode = "1920x1080@60";
|
|
# scale for your main monitor
|
|
defaultMonitorScale = "1";
|
|
# your username
|
|
username = "YOURNAME";
|
|
# TODO only needed when you use intel -> amd is default
|
|
# cpu = "intel";
|
|
locale = "something.UTF-8";
|
|
timezone = "CONTINENT/CITY";
|
|
};
|
|
# modules
|
|
mods = {
|
|
# default disk config has root home boot and swap partition, overwrite if you want something different
|
|
drives = {
|
|
# default assumes ROOT, BOOT, HOME and SWAP labaled drives exist
|
|
# for an example without HOME see below
|
|
# defaultDrives.enable = false;
|
|
# extraDrives = [
|
|
# {
|
|
# name = "boot";
|
|
# drive = {
|
|
# device = "/dev/disk/by-label/BOOT";
|
|
# fsType = "vfat";
|
|
# options = [ "rw" "fmask=0022" "dmask=0022" "noatime" ];
|
|
# };
|
|
# }
|
|
# {
|
|
# name = "";
|
|
# drive = {
|
|
# device = "/dev/disk/by-label/ROOT";
|
|
# fsType = "ext4";
|
|
# options = [ "noatime" "nodiratime" "discard" ];
|
|
# };
|
|
# }
|
|
# ];
|
|
};
|
|
sops.enable = false;
|
|
nextcloud.enable = false;
|
|
# default hyprland monitor config -> uncomment when necessary
|
|
# TODO: Add more monitors when needed
|
|
# hyprland.monitor = [
|
|
# # default
|
|
# "${config.conf.defaultMonitor},${config.conf.defaultMonitorMode},0x0,${config.conf.defaultMonitorScale}"
|
|
# # second example monitor
|
|
# "DP-2,3440x1440@180,auto,1"
|
|
# # all others
|
|
# ",highrr,auto,1"
|
|
# ];
|
|
# or amd, whatever you have
|
|
gpu.nvidia.enable = true;
|
|
kde_connect.enable = true;
|
|
# login manager:
|
|
# default is greetd
|
|
# greetd = { };
|
|
# sddm = { };
|
|
# gdm = { };
|
|
};
|
|
}
|
|
```
|
|
|
|
## First Login
|
|
|
|
After logging in the first time, your password will be set to "firstlogin", please change this to whatever you like.
|
|
|
|
## Nixos and Home-manager Modules
|
|
|
|
You can add additional modules or remove all of them by overriding parameters to the build_systems command:
|
|
|
|
```nix
|
|
nixosConfigurations =
|
|
let
|
|
additionalMods = {
|
|
nixos = [
|
|
# your modules
|
|
]; home = [
|
|
# your modules
|
|
];
|
|
}
|
|
# passing this parameter will override the existing modules
|
|
mods = {
|
|
nixos = [];
|
|
home = [];
|
|
}
|
|
in
|
|
(inputs.dashNix.dashNixLib.build_systems [
|
|
"system1"
|
|
] ./. mods additionalMods);
|
|
```
|
|
|
|
# Installation
|
|
|
|
You can find a custom ISO on my NextCloud server: [Link](https://cloud.dashie.org/s/z7G3zS9SXeEt2ER).
|
|
With this, you will receive the example config in /iso/example alongside the gnome desktop environment,
|
|
as well as a few tools like gnome-disks, neovim, vscodium, a browser etc.
|
|
|
|
Alternatively, you can use whatever NixOS installer and just install your config from there, just make sure to set the drive configuration before.
|
|
|
|
# Modules
|
|
|
|
This configuration features several modules that can be used as preconfigured "recipies".
|
|
These modules attempt to combine the home-manager and nixos packages/options to one single configuration file for each new system.
|
|
For package lists, please check the individual modules, as the lists can be long.
|
|
|
|
- base packages : A list of system packages to be installed by default
|
|
- home packages : A list of home packages to be installed by default
|
|
- media packages : A list of media packages to be installed by default
|
|
- coding packages : A list of coding packages to be installed by default
|
|
- acpid : Enables the acpid daemon
|
|
- bluetooth : Configures/enables bluetooth and installs tools for bluetooth
|
|
- drives : A drive configuration module
|
|
- flatpak : Installs and enables declarative flatpak
|
|
- gnome_services : Gnome services for minimal enviroments -> Window managers etc
|
|
- gpu : GPU settings (AMD)
|
|
- greetd : Enables and configures the greetd/regreet login manager with Hyprland
|
|
- kde_connect : Enables KDE connect and opens its ports
|
|
- layout : Modules to configure keyboard layout system wide
|
|
- piper : Installs and enables piper alongside its daemon
|
|
- printing : Enables and configures printing services
|
|
- virtualbox : Enables and configures virtualbox
|
|
- xone : Installs the xone driver
|
|
- starship : Configures the starship prompt
|
|
- keepassxc : Configures keepassxc
|
|
- gaming : Configures gaming related features (launchers, gamemode)
|
|
- stylix : Configures system themes, can also be applied to dashvim if used.
|
|
- git : Git key and config module
|
|
- nextcloud : Handles synchronization via nextcloud cmd. (requires config.sops.secrets.nextcloud)
|
|
- firefox: Enables and configures firefox (extensions and settings)
|
|
- Hyprland: Installs and configures Hyprland with various additional packages
|
|
- yazi: Installs yazi and sets custom keybinds
|
|
- teams: For the poor souls that have to use this....
|
|
- sops: Enables sops-nix
|
|
- fish: Enables and configures fish shell
|
|
- kitty: Enables and configures kitty terminal
|
|
- oxi: My own programs, can be selectively disabled, or as a whole
|
|
- mime: Mime type configuration
|
|
- xkb: Keyboard layout configuration
|
|
- scripts: Various preconfigured scripts with the ability to add more
|