Files
matrix-btw/readme.org
2026-02-18 19:50:11 +01:00

37 lines
883 B
Org Mode

#+TITLE: Matrix Homeserver on NixOS
* Prerequisites
- NixOS installed
- Domain with DNS pointing to server (A/AAAA Record matrix.domain.tld)
- Port 443
* Setup
1. Clone to =/etc/nixos= (or copy files)
2. Edit =matrix.nix= line 7: change =enter-your-domain= to your domain
3. Copy your =hardware-configuration.nix= into the directory
4. 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=)
- PostgreSQL configured automatically
- Intended usecase ipv6 lxc container with remote reverse proxy