Merge branch 'docs'

docs/setup/dovecot.md

@@ -1,6 +1,15 @@
 ---
 title: Install Dovecot on Debian 10
 sidebar: true
+notmine: false
+misc_links: >-
+    <a href="set_up_build_environments.md"  target="_blank">Set up build environments</a>.<br>
+    <a href="wireguard.html"  target="_blank">Wireguard</a>.<br>
+    <a href="nix.html"  target="_blank">nix</a>.<br>
+abstract: >-
+    These files are not specific to rhocoin.  This is a note on setting up dovecot.  Every time I mess around
+    and encounter some grief, I add to this pile of notes.
+
 ...
 
 # Purpose

docs/setup/nix.md

@@ -2,6 +2,19 @@
 title:
 	Nixos
 sidebar: true
+misc_links: >-
+  <a href="set_up_build_environments.md"  target="_blank">Set up build environments</a>.<br>
+  <a href="wireguard.html"  target="_blank">Wireguard</a>.<br>
+  <a href="dovecot.html"  target="_blank">Dovecot</a>.<br>
+abstract: >-
+  I know nothing about nix.  This file exists to record my learning
+  experience.\
+
+  \
+
+  The plan is to be able to install nix on debian, then load a reproducible
+  configuration file so that I can instantly and reproducibly produce a
+  host setup the way I want it.
 ...
 
 Nixos is primarily a package manager with a declarative functional language as its package manager.
@@ -16,8 +29,29 @@ on pinning to a specific Nixos release.
 
 # Install Nixos
 
+On linux running systemd, with SELinux disabled, with curl, as root
+
+```bash
+bash <(curl -L https://nixos.org/nix/install) --daemon
+```
+
+log off, then open a new terminal
+
+```bash
+nix-shell -p nix-info --run "nix-info -m"
+```
+
+
+You can open an issue at
+https://github.com/NixOS/nix/issues/new?labels=installer&template=installer.md
+
+Or get in touch with the community: https://nixos.org/community
+
 # minimal server
 
+This describes nixos, which I would like to use, but probably cannot
+be conveniently installed in a hosting service.
+
 ssh and avahi daemon, pubkeys setup for ssh, users created.
 
 ## configuration.nix
@@ -296,4 +330,4 @@ We have to pin to a particular release:  The following code is an example of suc
   security.acme.acceptTerms = true;
   security.acme.defaults.email = "security@example.com";
 }
-```
+```

docs/setup/set_up_build_environments.md

@@ -2,6 +2,15 @@
 title:
     Set up build environments
 sidebar: true
+notmine: false
+misc_links: >-
+    <a href="wireguard.html"  target="_blank">Wireguard</a>.<br>
+    <a href="dovecot.html"  target="_blank">Dovecot</a>.<br>
+    <a href="nix.html"  target="_blank">nix</a>.<br>
+abstract: >-
+    These files are not specific to rhocoin.  They are a collection
+    of notes on setting up operating systems and tools.  Every time I mess around
+    and encounter some grief, I add to this pile of notes.
 ...
 # partitioning for linux
 
@@ -254,7 +263,7 @@ ssh-keygen -t ed25519 -f  /etc/ssh/ssh_host_ed25519_key
 Note that visual studio remote compile requires an `ecdsa-sha2-nistp256` key on the host machine that it is remote compiling for.  If it is nist, it is
 backdoored
 
-To change the snake oil certificate:
+To change the snake oil certificate created and used by `xrdp`:
 
 ```bash
 make-ssl-cert generate-default-snakeoil --force-overwrite

docs/setup/wireguard.md

@@ -2,12 +2,14 @@
 title: Wireguard
 sidebar: true
 notmine: false
+misc_links: >-
+    <a href="set_up_build_environments.md"  target="_blank">Set up build environments</a>.<br>
+    <a href="dovecot.html"  target="_blank">Dovecot</a>.<br>
+    <a href="nix.html"  target="_blank">nix</a>.<br>
+abstract: >-
+    Setting up your own vpn using wireguard and a Debian 11 server in the cloud
 ...
 
-::: myabstract
-[abstract:]{.bigbold}Setting up your own vpn using wireguard and a Debian 11 server in the cloud
-:::
-
 This tutorial largely stolen from [Linuxbabe](https://www.linuxbabe.com/debian/wireguard-vpn-server-debian){target="_blank"}  It is slightly
 more up to date than her version at the time of writing.