#+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