Initial commit.

readme.org

@@ -0,0 +1,38 @@
+#+TITLE: Matrix Homeserver on NixOS
+
+* Prerequisites
+- NixOS installed
+- Domain with DNS pointing to server (A record: =matrix.yourdomain.com=)
+- Port 443, 8448 forwarded
+
+* Setup
+
+1. Clone to =/etc/nixos= (or copy files)
+2. Edit =matrix.nix= line 7: change =enter-your-domain= to your domain
+3. Edit =configuration.nix= line 30: set your ACME email
+4. Copy your =hardware-configuration.nix= into the directory
+5. Rebuild:
+#+begin_src sh
+nixos-rebuild switch --flake /etc/nixos#nixos-matrix
+#+end_src
+
+* Create Admin Account
+
+#+begin_src sh
+sudo matrix-synapse-register_new_matrix_user
+#+end_src
+
+Prompts for: username, password, admin (y/n)
+
+* Verify
+
+#+begin_src sh
+systemctl status matrix-synapse postgresql nginx
+#+end_src
+
+Test federation: https://federationtester.matrix.org
+
+* Notes
+- Registration disabled by default (=enable_registration = false=)
+- SSL via Let's Encrypt (automatic)
+- PostgreSQL configured automatically