tlaternet-server/etc/nixos/README.md

tlater.net server configuration

This is the NixOS configuration for tlater.net.

Testing

Building

To test locally in a VM, nix is required. Using a properly-configured nix, a qemu-based VM running the server can be created by first applying the following patch to disable hardware-specific configuration:

diff --git a/etc/nixos/configuration.nix b/etc/nixos/configuration.nix
index 387113d..aabee88 100644
--- a/etc/nixos/configuration.nix
+++ b/etc/nixos/configuration.nix
@@ -2,8 +2,8 @@

 {
   imports = [
-    ./hardware-configuration.nix
-    ./linode.nix
+    # ./hardware-configuration.nix
+    # ./linode.nix
   ];

   networking = {

Then building the VM with:

nix-build '<nixpkgs/nixos>' -A vm -k -I nixos-config=./configuration.nix

Running

To invoke the VM, use:

QEMU_NET_OPTS="hostfwd=tcp::2222-:2222,hostfwd=tcp::8000-:80" ./result/bin/run-tlater.net-vm

This will set up a qemu VM with ports 2222 linked to the ssh port, and 8000 to the http port. If other ports are required, adjust the environment variable (notably, ssl is provided by the image, although it should not work since it is unlikely that letsencrypt will supply any certificates).

Note that other environment variables are available (such as one for disabling the qt GUI, probably handy for eventual CI). They are listed under "Building a service as a VM (for testing)" here (not linked since the page isn't set up very nicely).