nix-bitcoin configuration for nixbitcoin.org

Highlights:

• A proof of concept donation page (src) with payment methods:
  • LNURL (LUD-06 and LUD-16/Lightning Address)
  • Lightning (bolt11)
  • Bitcoin on-chain
  • Liquid on-chain
• Matrix Synapse homeserver (src) with email registrations via a self-hosted mailserver. Public registrations are now disabled due to disk storage demands which are out of scope for this project.

Requirements

Nix >= 2.9, with flakes enabled.

Usage

Run nix develop to enter a dev shell (defined in lib/dev-env.nix) which provides deployment and development commands (like running the node in a container or VM).

You can also directly run a command like so:

nix develop -c <cmd>
nix develop -c help
nix develop -c deploy

./run-test runs the test. Requires root permissions because the test starts a container.

Branches

Branch deployed always contains the configuration that is currently deployed.

Deployment

To increase deployment speed, add a ControlMaster to your nixbitcoin.org config in ~/.ssh/config:

Host nixbitcoin.org
# ...
ControlMaster auto
ControlPath /tmp/ssh-connection-%r@%k-%p
ControlPersist 5m

See also

• Initial deployment
• maintenance.sh