document use as a NixOS configuration #339

Open
opened 2025-05-26 19:58:09 +02:00 by kiara · 0 comments
Owner

As a Nix developer,
I want to know how to consume Fediversity as a NixOS configuration,
so that using it will be simple.

implementation notes

  • in the data model approach (#494), the basic abstraction may not directly be a nixos configuration, tho given default application configs we should be able to straight-forwardly generate these for a given run-time environment, so one should no longer need multiple nodes or external tools. as such, we should document examples for deployment methods e.g. examples/live-usb.nix.
  • compare: #86
  • also note SelfHostBlocks asking to set the host's hosts to facilitate the SSL logic these modules try to work around
**As** a Nix developer, **I want** to know how to consume Fediversity as a NixOS configuration, **so that** using it will be simple. ### implementation notes - in the [data model approach](https://git.fediversity.eu/Fediversity/meta/src/branch/main/architecture-docs/architecture.md#configuration-data-flow) (#494), the basic abstraction may not directly be a nixos configuration, tho given default application configs we should be able to straight-forwardly generate these for a given run-time environment, so one should no longer need multiple nodes or external tools. as such, we should document examples for deployment methods e.g. `examples/live-usb.nix`. - compare: #86 - also note SelfHostBlocks asking to [set the host's `hosts`](https://github.com/ibizaman/selfhostblocks/blob/ef7f2212f501377b2b2b6a277b7ec7f9e91001f4/demo/nextcloud/README.md#nextcloud-with-ldap-through-http-demo-nextcloud-deploy-ldap) to facilitate the SSL logic these modules try to work around
kiara changed title from merge service NixOS configurations to make NixOS configuration the core abstraction 2025-05-27 14:54:24 +02:00
kiara changed title from make NixOS configuration the core abstraction to NixOS configuration the core abstraction 2025-06-01 09:56:42 +02:00
kiara changed title from NixOS configuration the core abstraction to NixOS configuration as the core abstraction 2025-06-01 12:57:16 +02:00
kiara changed title from NixOS configuration as the core abstraction to NixOS configuration as a first-class abstraction 2025-12-02 21:40:32 +01:00
kiara changed title from NixOS configuration as a first-class abstraction to document use as a NixOS configuration 2026-02-10 12:48:31 +01:00
kiara referenced this issue from a commit 2026-03-02 20:01:08 +01:00
kiara referenced this issue from a commit 2026-04-07 18:56:40 +02:00
kiara referenced this issue from a commit 2026-04-07 23:16:40 +02:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
fediversity/fediversity#339
No description provided.