isuggest.selfce.st / tangled-knot-nix
minimal nix config for running a tangled knot
fork atom
Nix 100.0%
1 1 0

Clone this repository

https://tangled.org/isuggest.selfce.st/tangled-knot-nix
git@tangled.org:isuggest.selfce.st/tangled-knot-nix

For self-hosted knots, clone URLs may differ based on your setup.

Download tar.gz
README.md

Tangled Knot for NixOS#

this repository is minimal example of how to properly set up a tangled knot on a machine running nixos.

Steps#

  1. install nixos. see the manual
  2. ensure that flakes are enabled on your system. nix.settings.experimental-features = [ "nix-command" "flakes" ];
  3. merge the config from this repository into your system flake, replacing values accordingly.
  4. rebuild your system. sudo nixos-rebuild switch

afterwards, the knot server will be running on port 5555. you may re-configure this in knot.nix along with other settings as documented here. the reference file contains these in comments, but you referencing source is always the most accurate.

remember to configure caddy or nginx accordingly to let traffic through to the port that the Knot server is listening on. an example caddy config is provided at caddy.nix.

Contributing#

issues and prs welcome. idk what you'd wanna pr though, this is like super basic.

Thanks to#