nixos/README.org

63 lines
1.6 KiB
Org Mode

#+title: Readme
* [0/1] Tasks
** [ ] rewrite README
* Misc notes
** mu init command
#+BEGIN_SRC bash
mu init --maildir ~/.mail\
--my-address=e.litherlandsmith@proton.me\
--my-address=e.litherlandsmith@icloud.com
#+END_SRC
* Old README.md
#+BEGIN_SRC markdown
# Personal NixOS configs
## Contains
- System definitions for various personal and work machines
- Desktop environment configs
- Plasma
- Hyprland
- Personal server config
- [Base domain](https://xenia.me.uk) # TODO
- [Gitea](https://git.xenia.me.uk)
- [AdGuardHome](https://guard.xenia.me.uk)
- ~[Nextcloud](https://cloud.xenia.me.uk)~
- Personal home environment definitions
## Installation
`Makefile` handles most things. Running `make` will determine if this is a NixOS or Nix home-manager only install. `make nixos` and `make home` execute either explicitly.
### NixOS
Clone repo into `/etc/nixos/config`, `make nixos` will do this for you otherwise. Edit your `/etc/nixos/configuration.nix` to import top level expression, e.g.:
```nix
{ config, pkgs, ... }: {
imports =
[
# Other imports (e.g. ./hardware-configuration.nix)
./config/hostname.nix
];
# Rest of your configuration.nix goes here
}
```
### Nix home-manager
**Must have `nix` installed to proceed**
Clone repo and run `make` or `make home`, a machine and user specific home-manager config will be created if it doesn't already exist, and then linked to `$XDG_CONFIG_HOME/home-manager/`. Execute:
```sh
nix-shell -p home-manager -- run "home-manager switch -b backup"
```
to install configuration. Home-manager will self-manager after this.
#+END_SRC