#+title: Readme

* [0/1] Tasks
** [ ] rewrite README

* Email setup
** Proton
*** Bridge
Docker source: [[https://hub.docker.com/r/shenxn/protonmail-bridge][Docker]] / [[https://github.com/shenxn/protonmail-bridge-docker][GitHub - shenxn/protonmail-bridge-docker: ProtonMail IMAP/SMTP Bridge Docker ...]]

To initialise:
#+begin_src bash
podman run --rm -it -v protonmail:/root shenxn/protonmail-bridge init
#+end_src
and follow normal login system for cli.

systemd unit handles running container on boot after this.
*** Password
Get password from protonmail-bridge, register with gnome-keyring:
#+begin_src bash
secret-tool store --label="Proton mail mbsync" email e.litherlandsmith@proton.me
#+end_src
** iCloud
*** Password
Register app-password with gnome-keyring:
#+begin_src bash
secret-tool store --label="iCloud mail mbsync" email e.litherlandsmith@icloud.com
#+end_src
** UKAEA
*** Davmail
Docker source: [[https://hub.docker.com/r/connectical/davmail/][Docker]]

No setup needed but initial pull may take a while, if systemd unit times out run:
#+begin_src bash
podman run --rm -d --name=davmail -p 127.0.0.1:1026:1025 -p 127.0.0.1:1144:1143 -p 127.0.0.1:1080:1080 connectical/davmail
#+end_src
and subsequent systemd runs should start fine.
*** Password
Register app-password with gnome-keyring:
#+begin_src bash
secret-tool store --label="UKAEA mail mbsync" email evie.litherlandsmith@ukaea.uk
#+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