69 lines
No EOL
4.3 KiB
Org Mode
69 lines
No EOL
4.3 KiB
Org Mode
#+title: Flake Readme
|
|
#+author: Zonsopkomst
|
|
#+date: 2022-11-30
|
|
* My NixOS Configuraton File
|
|
This is my NixOS setup to manage multiple computers with a home-manager config structure using nix flakes.
|
|
|
|
** Current Desktop Screenshots:
|
|
*** Gnome
|
|
#+caption: Gnome
|
|
#+attr_org: :width 200
|
|
[[Gnome][https://git.disroot.org/Zonsopkomst/flake/raw/branch/working/reference/assets/20231102NixOSTyr3.png]]
|
|
|
|
** Emacs
|
|
#+caption: Emacs
|
|
#+attr_org: :width 200
|
|
[[Gnome][https://git.disroot.org/Zonsopkomst/flake/raw/branch/working/reference/assets/20231102NixOSTyr.png]]
|
|
|
|
** Highlights:
|
|
*** Multiple NixOS configurations: desktop, laptop, and hopefully a test server and eventually a full transition over from my Ubuntu server.
|
|
|
|
** How to:
|
|
#+caption: South Park
|
|
#+attr_org: :width 500
|
|
[[Process][https://git.disroot.org/Zonsopkomst/flake/raw/branch/working/reference/assets/underpants-gnomes.png]]
|
|
|
|
1. NixOS Installation
|
|
1. Install NixOS on a computer using the default Gnome installer from [https://nixos.org/download.html].
|
|
1. Clone this repository [https://git.disroot.org/zonsopkomst] in the `/home/<username>/ directory.
|
|
1. Update the subdirectories in `hosts` and `users`.
|
|
1. Copy the `configuration.nix` and `hardware-configuration.nix` files from the `/etc/nixos` directory and move them to `hosts/PLACE(local OR remote)/NEW_PC_NAME`.
|
|
1. Rename `configuration.nix` to `default.nix` and, update `flake.nix` located in the top directory, link the appropriate modules to be used.
|
|
2. Segment out items from new `default.nix` to appropriate `.nix` files.
|
|
3. Make sure the correct version of NixOS is listed in the appropriate files.
|
|
2. `flake.nix` is where `.nix` files are imported with further instructions on declared packages and modules.
|
|
1. Declare packages either globally under `/hosts/<location>/hostname/packages.nix` or `/users/<username>/home-manager.nix`.
|
|
3. Rebuild NixOS *(<hostname> must be include the first time rebuilding, after the first rebuild, .# can be used and the system will know which hostname is to be used)*
|
|
1. `nix flake --update && nixos-rebuild switch --flake .#<hostname>`
|
|
4. Push the updated git files to the repository so that they can be pulled, and the system rebuilt during the next update.
|
|
|
|
*** Maintenance
|
|
1. See `/config/.bashrc` for `alias`: `flkup` using `sudo nixos-rebuild switch --flake .#<hostname>` commands and other useful items
|
|
|
|
*** Sources
|
|
**** Nix Flakes: [https://nixos.wiki/wiki/Flakes]
|
|
**** home-manager: [https://github.com/nix-community/home-manager]
|
|
***** Home Manager as a NixOS Module: [https://nix-community.github.io/home-manager/index.html#sec-flakes-nixos-module]
|
|
|
|
|
|
** Structure
|
|
| Directory | What is it for? |
|
|
| common | Shared configurations and modules |
|
|
| config | Config files that are managed by NixOS |
|
|
| desktop | Shared desktop configs |
|
|
| display | Login Display managers |
|
|
| hosts | The PCs deployed |
|
|
| reference | Package list, git assets, notes, etc. |
|
|
| users | Individual User configs |
|
|
| flake.nix & flake.lock | Declared configuration using the above directories & configs |
|
|
|
|
** Hosts
|
|
| Hostname | Model | Type | RAM | Processor | Main Use |
|
|
| weda | Dell Inspiron 15 | Laptop | 16GB | AMD Ryzen 5 (Cezanne) | Business |
|
|
| frija | Acer Aspire 3 | Laptop | 4GB | AMD A9 | Testing |
|
|
| tyr | Intel i5 | Desktop | 16GB | Intel i5 | Media |
|
|
| tii | Dell Lattitude 5511 | Laptop | 16GB | Intel i5 Quad (i5-10400H) | Remote |
|
|
| tuisto | AMD Ryzen 5 | Desktop | 16GB | AMD Ryzen 5 (Renoir) | Remote |
|
|
| sintanne | Intel i5 | Desktop | 16GB | Intel i5-11320H | Remote |
|
|
| thuner | AMD Ryzen 5 | Server | ??GB | AMD 2200G | Test Server |
|
|
| fryslan (Ubuntu) | AMD Ryzen 5 | Server | ??GB | AMD 2200G | Main Server | |