Contribute or troubleshoot¶
To report an issue, please go to https://gitlab.com/simple-nixos-mailserver/nixos-mailserver/-/issues.
You can also chat with us on the Libera IRC channel #nixos-mailserver.
Run NixOS tests¶
You can run the testsuite via
$ nix-build tests -A external.nixpkgs_20_03
$ nix-build tests -A internal.nixpkgs_unstable
...
Contributing to the documentation¶
The documentation is written in RST, build with Sphinx and published by Read the Docs.
For the syntax, see RST/Sphinx Cheatsheet.
The shell.nix provides all the tooling required to build the
documentation:
$ nix-shell
$ cd docs
$ make html
$ firefox ./_build/html/index.html
Nixops¶
You can test the setup via nixops. After installation, do
$ nixops create nixops/single-server.nix nixops/vbox.nix -d mail
$ nixops deploy -d mail
$ nixops info -d mail
You can then test the server via e.g. telnet. To log into it, use
$ nixops ssh -d mail mailserver