fediversity/fediversity

Watch

applications' configuration options exposed #627

New issue

Open

opened 2025-12-03 15:17:50 +01:00 by kiara · 1 comment

kiara commented

2025-12-03 15:17:50 +01:00

Owner

As a Fediversity user,
I want Fediversity to expose applications' configuration options using schemas,
so that I may better control my deployments.

implementation notes

Upstream repos may not offer (JSON) schema.
May need better conversion from nix option modules (#626).
On the Nix side this may involve overriding relevant unstructured (.settings) types with a schema-derived type (c.f. builtins.jsonSchemaValidate).

upstream configuration schema availability by application:

mastodon: n/a, uses env vars (issue, PR)
pixelfed: env-var-like php config (issue, PR)
peertube: ticket
authelia

complications:

settings relevant to both operators and hosting providers (e.g. limits that both may have opinions on, either in the sense that both may want to limit them, as well as in the sense that operators may want some limits heightened that hosting providers might impose by default, which might affect resource use and thus billing, in the event such choices were to affect load on shared resources)
wild-card env vars

**As** a Fediversity user, **I want** Fediversity to expose applications' configuration options using schemas, **so that** I may better control my deployments. ### implementation notes - Upstream repos may not offer (JSON) schema. - May need better conversion from nix option modules (#626). - On the Nix side this may involve overriding relevant unstructured (`.settings`) types with a schema-derived type (c.f. [`builtins.jsonSchemaValidate`](https://github.com/NixOS/nix/issues/5392)). upstream configuration schema availability by application: - [ ] mastodon: n/a, [uses env vars](https://docs.joinmastodon.org/admin/config/) ([issue](https://github.com/mastodon/mastodon/issues/36074), [PR](https://github.com/mastodon/mastodon/pull/38474)) - [ ] pixelfed: [env-var-like php config](https://docs.pixelfed.org/running-pixelfed/configuration.html) ([issue](https://github.com/pixelfed/pixelfed/issues/6168), [PR](https://github.com/pixelfed/pixelfed/pull/6555)) - [x] peertube: [ticket](https://github.com/Chocobozzz/PeerTube/issues/6903) - [x] [authelia](https://github.com/authelia/authelia/blob/master/docs/static/schemas/latest/json-schema/configuration.json) complications: - [ ] settings relevant to both operators and hosting providers (e.g. limits that both may have opinions on, either in the sense that both may want to limit them, as well as in the sense that operators may want some limits heightened that hosting providers might impose by default, which might affect resource use and thus billing, in the event such choices were to affect load on shared resources) - [ ] wild-card env vars

kiara added the

labels

2025-12-03 15:17:50 +01:00

kiara added a new dependency

2025-12-03 15:18:03 +01:00

#626 nix to json schema coverage

kiara added a new dependency

2025-12-03 15:18:38 +01:00

#195 NixOS modules' options exposed

kiara added a new dependency

2025-12-03 15:20:00 +01:00

#159 Hosting providers can update their operators' deployments

kiara referenced this issue

2025-12-03 15:21:29 +01:00

Configure applications #610

kiara added a new dependency

2025-12-03 15:21:34 +01:00

#610 Configure applications

kiara referenced this issue

2025-12-03 15:22:57 +01:00

key features improving user experience supported #289

kiara referenced this issue

2025-12-03 15:28:19 +01:00

schema updates automated #629

kiara added a new dependency

2025-12-03 15:28:48 +01:00

#629 schema updates automated

kiara removed a dependency

2025-12-03 17:29:27 +01:00

#159 Hosting providers can update their operators' deployments

kiara removed a dependency

2025-12-03 17:34:14 +01:00

#195 NixOS modules' options exposed

kiara referenced this issue

2025-12-03 17:37:20 +01:00

NixOS modules' options exposed #195

kiara added the

configure-applications

label

2026-06-11 15:55:47 +02:00

kerstin self-assigned this

2026-07-01 15:32:13 +02:00

kiara added a new dependency

2026-07-01 15:32:22 +02:00

#195 NixOS modules' options exposed

kerstin added this to the Fediversity project

2026-07-28 14:22:51 +02:00

kiara referenced this issue

2026-07-30 14:22:21 +02:00

applications' operator-facing options selected #1245

kiara added a new dependency

2026-07-30 14:22:36 +02:00

#1245 applications' operator-facing options selected

toonn modified the project from Fediversity to Dev

2026-08-04 12:00:17 +02:00

kiara changed title from ~~expose applications' configuration options~~ to applications' configuration options exposed

2026-08-05 15:47:14 +02:00

kiara commented

2026-08-05 15:48:03 +02:00

Author

Owner

looks like authelia had one too /cc @toonn

looks like authelia had one too /cc @toonn

kiara referenced this issue

2026-08-19 21:51:22 +02:00

NixOS modules' options exposed #195

kiara removed a dependency

2026-08-20 10:21:38 +02:00

#629 schema updates automated

kiara added a new dependency

2026-09-06 15:10:21 +02:00

#1696 WIP: lib: remove upgrade from the JSON Schema library

kiara referenced this issue

2026-09-06 15:11:01 +02:00

WIP: lib: remove upgrade from the JSON Schema library #1696

Sign in to join this conversation.

No labels

application-offering

configure-applications

ambition/install-applications

update-applications

user-management

component: fediversity panel

component: nixops4

estimation high: >3d

estimation low: <2h

estimation mid: <8h

infinite points

project-management

role: application developer

role: application operator

role: hosting provider

role: maintainer

type: deliverable

type: key result

type: objective

type: user story

user experience

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.

Blocks

#610 Configure applications

fediversity/fediversity

#1696 WIP: lib: remove upgrade from the JSON Schema library

fediversity/fediversity

Depends on

#195 NixOS modules' options exposed

fediversity/fediversity

#626 nix to json schema coverage

fediversity/fediversity

#1245 applications' operator-facing options selected

fediversity/fediversity

Reference

fediversity/fediversity#627

No description provided.