discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens
reo101/rix101 · source
Snapshot 0 · 2026-11-04T12:47:27Z · Nix · MIT
Content fingerprint
4f96c025598eeb0f6fd800b897d455117df3055740b6e05cfa4166262c9ca523GitHub description at capture
My NixOS, nix-on-droid and nix-darwin configs.
README at capture
<!-- <div align="center">
<p>
<a href="https://github.com/NixOS">
<img src="https://img.shields.io/badge/NixOS?style=flat-square&logo=nix" alt="NixOS"/>
</a>
<a href="https://github.com/t184256/nix-on-droid">
<img src="https://img.shields.io/badge/nix%2Don%2Ddroid?style=flat-square&logo=nix" alt="nix-on-droid"/>
</a>
<a href="https://github.com/LnL7/nix-darwin">
<img src="https://img.shields.io/badge/nix%2Ddarwin?style=flat-square&logo=nix" alt="nix-darwin"/>
</a>
</p>
<p>
<a href="https://nixos.org/">
<img src="https://img.shields.io/badge/Made%20with%20Nix-lightblue.svg?style=for-the-badge&logo=nix" alt="Nix"/>
</a>
<a href="https://github.com/reo101/rix101/blob/main/LICENSE">
<img src="https://img.shields.io/github/license/reo101/rix101?style=flat-square&logo=MIT&label=License" alt="License"/>
</a>
<a href="https://github.com/reo101/rix101/pulse">
<img alt="Last Commit" src="https://img.shields.io/github/last-commit/reo101/rix101"/>
</a>
</p>
</div> -->
<!-- ```
___ ___ ___
/ /\ / /\ /__/|
/ /::\ / /:/ | |:|
/ /:/\:\ /__/::\ | |:|
/ /:/~/:/ \__\/\:\ __|__|:|
/__/:/ /:/___ \ \:\ /__/::::\____
\ \:\/:::::/ \ \:\__ ~\~~\::::/
\ \::/~~~~ \ \:\/\ |~~|:|~~
\ \:\ \__\::/ | |:|
\ \:\ /__/:/ | |:|
\__\/ \__\/ |__|/
``` -->
<!-- TODO: badges? -->
<div align="center">
</div>
---
# Structure
- Everything is built upon [flake-parts](https://flake.parts/), with [flake modules](./modules/flake/) for automatic *stuff* extraction
- Flake metadata (inputs, `description`, `nixConfig`) is managed by [`flake-file`](https://github.com/denful/flake-file) via a [dedicated flake-parts module](./modules/flake/flake-file.nix) — `flake.nix` is an auto-generated artifact (regenerated with `nix run .#write-flake`), keeping it a dumb dependency manifest while all real logic lives in the module tree
- Automatic `nixos`, `nix-darwin`, `nix-on-droid`, `home-manager`, `openwrt` and `liminix` configurations extraction
- Automatic `nixos`, `nix-darwin`, `nix-on-droid`, `home-manager` and `flake` modules extraction
- Automatic classic (`callPackage`) and `dream2nix` packages extraction
- Automatic apps extraction
- Automatic overlays extraction
- Automatic devShells extraction
- Automatic flake templates extraction from `./templates/*/flake.nix`
- Hosts can be found under `./hosts/${config-type}/${system}/${hostname}/...`
- Check [`./modules/flake/configurations`](./modules/flake/configurations) for more info on what is extracted from those directories
- Modules can be found under `./modules/${config-type}/...`
- Check [`./modules/flake/modules`](./modules/flake/modules) for more info on what is extracted from that directory
- Packages can be found under `./pkgs/...`
- Check [`./modules/flake/packages`](./modules/flake/packages) for more info on what is extracted from that directory
- Apps can be found under `./apps/...`
- `*.nix` files and directories containing `default.nix` are exposed as `flake.apps`
- Check [`./modules/flake/apps`](./modules/flake/apps) for more info on what is extracted from that directory
- Overlays can be found under `./overlays/...`
- Check [`./modules/flake/overlays`](./modules/flake/overlays) for more info on what is extracted from that directory
- Shells can be found under `./shells/...`
- Check [`./modules/flake/shells`](./modules/flake/shells) for more info on what is extracted from that directory
- Default one puts a recent `nix` together with some other useful tools for working with the repo (`deploy-rs`, `rage`, `agenix-rekey`, etc.), see [`./shells/default/default.nix`](./shells/default/default.nix) for more info
- Templates can be found under `./templates/...`
- Directories containing `flake.nix` are exposed as `flake.templates`
- Optional `description.nix` and `welcomeText.nix` files can add template metadata
- Check [`./modules/flake/templates`](./modules/flake/templates) for more info on what is extracted from that directory
# Topology
You can see the overall topology of the hosts by running
```sh
nix build ".#topology"
```
And opening the resulting `./result/main.svg` and `./result/network.svg`
---
# Secrets
Secrets are managed by [`agenix`](https://github.com/ryantm/agenix) and [`agenix-rekey`](https://github.com/oddlama/agenix-rekey)
> [!NOTE]
> Secrets are defined by the hosts themselves, `agenix-rekey` *just* collects what secrets are referenced by them and lets you generate, edit and rekey them
```sh
# To put `rage`, `agenix-rekey` and friends in `$PATH`
nix develop
```
## Edit secret
```sh
# Select from `fzf` menu
agenix edit
```
## Rekey all secrets
```sh
agenix rekey
```
## Generate missing keys (with the defined `generators`)
```sh
agenix generate
```
---
# Setups
## NixOS setup
```sh
# Initial setup
nix run nixpkgs#nixos-anywhere -- --flake ".#${HOSTNAME}" --build-on-remote --ssh-port 22 "root@${HOSTNAME}" --no-reboot
# Deploy
deploy ".#${HOSTNAME}"
```
## MacOS / Darwin (silicon) setup
```sh
# Setup system tools
softwareupdate --install-rosetta --agree-to-license
sudo xcodebuild -license
# Install nix
curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install
# Apply configuration
git clone https://www.github.com/reo101/rix101 ~/.config/rix101
cd ~/.config/rix101
nix build ".#darwinConfigurations.${HOSTNAME}.system"
./result/sw/bin/darwin-rebuild switch --flake .
# System setup for `yabai` (in system recovery)
# NOTE: <https://support.apple.com/guide/mac-help/macos-recovery-a-mac-apple-silicon-mchl82829c17/mac>
csrutil enable --without fs --without debug --without nvram
```
---
# Credits
- [`Misterio77`](https://github.com/Misterio77) for his amazing [`nix-starter-configs`](https://github.com/Misterio77/nix-starter-configs), on which this was based originally
- [`disko`](https://github.com/nix-community/disko) for making disk partioning a breeze
- [`oddlama`](https://github.com/oddlama) for creating the amazing [`agenix-rekey`](https://github.com/oddlama/agenix-rekey) and [`nix-topology`](https://github.com/oddlama/nix-topology) projects