alyraffauf/nixcfg
1
0
Fork 0
mirror of https://github.com/alyraffauf/nixcfg.git synced 2024-11-21 19:53:55 -05:00
Code Issues Actions Packages Projects Releases Wiki Activity

hosts: added wifi docs

Browse source
This commit is contained in:
Aly Raffauf 2024-07-20 20:36:31 -04:00
parent eefffed94f
commit 5676ebb9e7
1 changed files with 21 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

21
hosts/common/README.md
View file

@ -3,3 +3,24 @@
## Overview
Common modules for my nix hosts that aren't better expressed as options & flake outputs.
## Declarative WiFi Connections
WiFi networks can be configured declaratiely in `nixosModules/system/wifi.nix` using `config.networking.networkmanager.ensureProfiles.profiles`, provided by nixpkgs.
[nm2nix](https://github.com/janik-haag/nm2nix) can generate nix code for all WiFi networks currently configured in `/etc/NetworkManager/system-connections/` and `/run/NetworkManager/system-connections` with the following command:
```bash
sudo su -c "cd /etc/NetworkManager/system-connections && nix --extra-experimental-features 'nix-command flakes' run github:Janik-Haag/nm2nix | nix --extra-experimental-features 'nix-command flakes' run nixpkgs#nixfmt-rfc-style"
```
\[\[Secrets\]\] (passwords, certificates, and identities) are supported, but must be declared and available as variables with agenix. They will be replaced upon activation with `envsubst`.
In short,
1. Manually configure the WiFi network on one device.
1. Export configuration to nix with `nm2nix`.
1. Add secrets to `secrets/wifi.age` as variables (e.g. `MYPSK=1234567890`)
1. Edit the code generated by `nm2nix` to reference `$MYPSK` instead of directly declaring the WPA password.
1. Commit and push changes.
1. Rebuild hosts as required to propogate your new WiFi configuration.