expanded README

This commit is contained in:
Aly Raffauf 2024-03-04 23:42:20 -05:00
parent 5806a7a611
commit 988ec394e4

View file

@ -1,21 +1,30 @@
# nixcfg # nixcfg
![](./_img/nixos-gnome.png) ![](./_img/nixos-gnome.png)
## Hosts
### Petalburg
Lenovo Yoga 9i Gen 8 convertible running nixos-unstable. Core i7 1360P, 15GB RAM, 512GB SSD. Runs GNOME, home directory managed by [home-manager](https://github.com/nix-community/home-manager).
### Rustboro
Thinkpad T440p running nixos-unstable. Uses KDE Plasma 6. Home directory managed by home-manager.
### Mauville
Gaming desktop & home lab running [Slateblue](https://github.com/alyraffauf/slateblue), a customized [Fedora Silverblue](https://fedoraproject.org/atomic-desktops/silverblue/) image made with [BlueBuild](https://github.com/blue-build/template). Home directory managed by home-manager. Ryzen 5 2600, 16GB RAM, Radeon RX 6700.
## Deploying to NixOS ## Deploying to NixOS
> :red_circle: **READ**: **Do not deploy this flake directly to your machine. It won't work.** > :red_circle: **READ**: **Do not deploy this flake directly to your machine. It won't work.**
> This is my own NixOS and home-manager flake for my personal devices. > This is my own [NixOS](https://nixos.org/) and [home-manager](https://github.com/nix-community/home-manager) flake for my personal devices.
> This includes laptops running nixos-unstable and a home lab/gaming desktop running [Slateblue](https://github.com/alyraffauf/slateblue),
> a customized [Fedora Silverblue](https://fedoraproject.org/atomic-desktops/silverblue/) image made with [BlueBuild](https://github.com/blue-build/template).
> Each hardware-configuration is host-specific. If you fork this repository, replace them with the hardware-configuration.nix that NixOS generates for you. > Each hardware-configuration is host-specific. If you fork this repository, replace them with the hardware-configuration.nix that NixOS generates for you.
### Enabling Flakes ### Enabling Flakes
Add the following lines to your `configuration.nix` and rebuild. While widely used and considered stable, [flakes](https://nixos.wiki/wiki/Flakes) are still considered eperimental. To enable Flakes, add the following lines to your `configuration.nix` and rebuild.
```nix ```nix
nix.settings.experimental-features = [ "nix-command" "flakes" ]; nix.settings.experimental-features = [ "nix-command" "flakes" ];
``` ```
### Building Flake ### Building Flake
Run the following command. In order to deploy this Flake on your host, run the following command:
```bash ```
sudo nixos-rebuild boot --flake github:alyraffauf/nixcfg sudo nixos-rebuild boot --flake github:alyraffauf/nixcfg
``` ```
Reboot and the flake's configuration will be applied. Reboot to apply the flake's configuration for the chosen host.