57 lines
1.5 KiB
Markdown
57 lines
1.5 KiB
Markdown
# tlater.net server configuration
|
|
|
|
This is the NixOS configuration for [tlater.net](https://tlater.net/).
|
|
|
|
## Testing
|
|
|
|
### Building
|
|
|
|
To test locally in a VM, [nix](https://nixos.org/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:
|
|
|
|
```patch
|
|
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](https://nixos.wiki/wiki/Cheatsheet) (not linked since the page
|
|
isn't set up very nicely).
|