mirror of
https://seed.radicle.dev/rad:z254T5p17bdFPmzfDojsdjo4HjpoZ.git
synced 2026-11-21 18:40:42 +08:00
This is too cumbersome to update, and also in the last two weeks two people with Nixpkgs commit access got more interested in Radicle, thus hopefully making turnaround quicker, obsoleting `radicle-nix`.
61 lines
1.5 KiB
Markdown
61 lines
1.5 KiB
Markdown
# radicle-infra
|
||
|
||
Easing the deployment of Radicle seed nodes with the magic of Nix 🌱 ➕ ❄️
|
||
|
||
## Deployment
|
||
|
||
Then to deploy to the target, for example `seed.radicle.xyz`, use the following
|
||
command. You might have to adjust the value of `$USER` if the username on your
|
||
local machine does not match the username of your account on the target machine.
|
||
Also, note that you may have to get permission to be added as a user first:
|
||
|
||
```
|
||
HOST=seed.radicle.xyz; nixos-rebuild switch --target-host "${USER}@${HOST}" --build-host "${USER}@${HOST}" --use-remote-sudo --flake .
|
||
```
|
||
|
||
### Overlays
|
||
|
||
To deploy a versions of packages that are not upstreamed (e.g. pre-releases),
|
||
use the overlays in `./overlay`.
|
||
|
||
Then the following option should be changed in `os/host/seed/radicle.nix`:
|
||
|
||
```nix
|
||
{pkgs, ...}: {
|
||
# Use Nixpkgs
|
||
services.radicle.package = pkgs.radicle-node;
|
||
|
||
# Use overlaid version.
|
||
services.radicle.package = pkgs.radicle-node-overlay;
|
||
}
|
||
```
|
||
|
||
## DNS
|
||
|
||
The radicle.xyz. zone is configured via [DNSControl].
|
||
Previewing and pushing changes requires a [Cloudflare API Token] in the environment at `CLOUDFLARE_API_TOKEN`.
|
||
|
||
In `/dns`:
|
||
|
||
Sanity-check with:
|
||
|
||
dnscontrol check
|
||
|
||
Preview changes with:
|
||
|
||
dnscontrol preview
|
||
|
||
If the preview looks good, finally
|
||
|
||
dnscontrol push
|
||
|
||
Please keep `dnsconfig.js` tidy with
|
||
|
||
dnscontrol fmt > tmp.js && mv tmp.js dnscontrol.js
|
||
|
||
(As of 2025-06, there is no pre-commit hook for `dnscontrol`.)
|
||
|
||
|
||
[Cloudflare API Token]: https://dash.cloudflare.com/profile/api-tokens
|
||
[DNSControl]: https://docs.dnscontrol.org
|