asgard
> [!IMPORTANT]
> This configuration is under constant construction so some things may be remove or add accordings to my needs but i want to keep all even if it's not used anymore.
>
> Since this configuration is made for my own needs, you can take inspiration and some configuration but do not expect it to work on your side.
>
> Any damage caused by this configuration is not my responsibility, so use it at your own risks.
## Table of Contents
- [Features & Capabilities](#features--capabilities)
- [Machines](#machines)
- [Installation](#installation)
- [Folder Structure](#folder-structure)
- [Commands](#commands)
- [Documentations](#documentations)
- [Troubleshooting](#troubleshooting)
## Features & Capabilities
This repository want this to be multi-user and multi-host so there is some workaround to make things work like i want and keep it simple.
- [x] NixOS
- [x] Nix Darwin
- [ ] WSL (because not used anymore)
- [ ] Nix BSD (in wait of a stable state to be used anywhere else than a vm)
- [ ] MicroVM for servers
- [ ] Secrets management
- [ ] Secure Boot
- [ ] Persistant storage
- [ ] Disk configuration
- [ ] Encrypted disks
- [ ] Home management
- [ ] Custom live ISO
- [ ] Automatic updates
## Installation
> TODO: write the documentation to install easely a new host with a few steps
## Machines
| Hostname | Motherboard | CPU | GPU | RAM | OS | Usage | Status |
| :------------- | :-------------------------------- | :------------------- | :------------ | :--: | :-: | :------: | :----: |
| `njord` | - | Apple M2 Pro | Apple M2 Pro | 32Go | đī¸ | â¨ī¸ | đĸī¸ |
| `loki` | ASUS ROG STRIX B760-I GAMING WIFI | Intel i5 13600kf | Nvidia 4070ti | 32Go | âī¸ | đŽī¸ | đĸī¸ |
| `lithium` | Raspberry Pi3 b+ | - | - | 1Go | âī¸ | đ§¨ī¸ | đ´ |
| `vali` | WSL | - | - | 8Go | âī¸ | đžī¸ | đ´ |
| `andhrimnir` | Aorus B450 Elite | AMD Ryzen 3 3300X | Nvidia 1060 | 16Go | âī¸ | đŽī¸ / â¨ī¸ | đĸī¸ |
| `elli` | HP ProDesk 400 G1 DM | Intel Pentium G3250T | - | 8Go | âī¸ | đžī¸ | đ |
| `sunna` | ASUS ROG STRIX G15 | Intel i7 10870H | Nvidia 2060 | 16Go | âī¸ | đĨī¸ | đ´ |
Legend
- đŽī¸ : Gaming
- đžī¸ : Server
- âī¸ : Virtual Machime
- â¨ī¸ : Coding
- đĨī¸ : Office
- đ§¨ī¸ : Testing purpose
- đī¸ : Dual Boot
- âī¸ : NixOS
- đī¸ : MacOS
- đšī¸ : FreeBSD with [NixBSD](https://github.com/nixos-bsd/nixbsd)
## Folder structure
> TODO: write the new documentation with the dentritic pattern usage
## Commands
You can get all recipes using the `just` command and running one of the available commands below with `just `:
```sh
Available recipes:
boot hostname=hostname # Build a new configuration
clean # Cleanup all unused packages and generations
format # Format code
size # Print size of the nix store
switch hostname=hostname # Rebuild the system
update # Update dependencies
```
## Documentations
These are the things that help me the most to understand Nix ecosystem and help me build my configuration from scratch.
You can retrieve dotfiles that inspired me inside my [`dotfiles` star list](https://github.com/stars/Cosmeak/lists/useful-dotfiles).
- [Flakes book](https://nixos-and-flakes.thiscute.world/)
- [Nix Language](https://nix.dev/)
- [Nix Tour](https://nixcloud.io/tour/?id=introduction/nix)
- [Dentritic Pattern explanation](https://github.com/Doc-Steve/dendritic-design-with-flake-parts)
## Troubleshooting
- If the rebuild command failed because an experimental feature is disabled use this command:
```sh
sudo -E NIX_CONFIG="experimental-features = nix-command flakes pipe-operators" nixos-rebuild switch --flake .
```