conduwuit/docs/deploying/nixos.md

conduwuit for NixOS

conduwuit can be acquired by Nix (or Lix) from various places:

• The flake.nix at the root of the repo
• The default.nix at the root of the repo
• From conduwuit's binary cache

A community maintained NixOS package is available at conduwuit

Binary cache

A binary cache for conduwuit that the CI/CD publishes to is available at the following places (both are the same just different names):

https://attic.kennel.juneis.dog/conduit
conduit:eEKoUwlQGDdYmAI/Q/0slVlegqh/QmAvQd7HBSm21Wk=

https://attic.kennel.juneis.dog/conduwuit
conduwuit:BbycGUgTISsltcmH0qNjFR9dbrQNYgdIAcmViSGoVTE=

The binary caches were recreated some months ago due to attic issues. The old public keys were:

conduit:Isq8FGyEC6FOXH6nD+BOeAA+bKp6X6UIbupSlGEPuOg=
conduwuit:lYPVh7o1hLu1idH4Xt2QHaRa49WRGSAqzcfFd94aOTw=

If specifying a Git remote URL in your flake, you can use any remotes that are specified on the README (the mirrors), such as the GitHub: github:girlbossceo/conduwuit

NixOS module

The flake.nix and default.nix do not currently provide a NixOS module (contributions welcome!), so services.matrix-conduit from Nixpkgs can be used to configure conduwuit.

If you want to run the latest code, you should get conduwuit from the flake.nix or default.nix and set services.matrix-conduit.package appropriately to use conduwuit instead of Conduit.

UNIX sockets

Due to the lack of a conduwuit NixOS module, when using the services.matrix-conduit module it is not possible to use UNIX sockets. This is because the UNIX socket option does not exist in Conduit, and their module forces listening on [::1]:6167 by default if unspecified.

Additionally, the matrix-conduit systemd unit in the module does not allow the AF_UNIX socket address family in their systemd unit's RestrictAddressFamilies= which disallows the namespace from accessing or creating UNIX sockets.

There is no known workaround these. A conduwuit NixOS configuration module must be developed and published by the community.

jemalloc and hardened profile

conduwuit uses jemalloc by default. This may interfere with the hardened.nix profile due to them using scudo by default. You must either disable/hide scudo from conduwuit, or disable jemalloc like so:

let
    conduwuit = pkgs.unstable.conduwuit.override {
      enableJemalloc = false;
    };
in