Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

Store relay settings overrides in PostgreSQL (SETTINGS_BACKEND=db)

Aberta
  • Algo errado?
#757 0 comentários 0 reações 1 responsável Ver no GitHub

Mantenedores costumam responder em até 1 dia

@Ferryx349 já está trabalhando nisso.

Desde 5/9/2026.

Avaliação

Esta issue ainda não foi avaliada.

Descrição

enhancement

Problem

Operator settings overrides currently live in settings.yaml under NOSTR_CONFIG_DIR with legacy settings.json fallback. That creates operational friction:

  • When nostream releases add new default settings keys, operators editing YAML may not know new values exist or need to be added.
  • Deploy/bootstrap flows copy config files that can drift from what the application expects after upgrades.
  • Operators end up maintaining files that are easy to overwrite or fall out of sync with releases.
    We need durable storage for operator overrides that survives upgrades without requiring manual YAML edits for every new setting.

Proposal

Store only operator overrides in PostgreSQL — not the full settings blob. Shipped defaults remain in resources/default-settings.yaml and are merged at runtime.

  • Add a settings_overrides table (path TEXT PK, value JSONB, updated_at TIMESTAMPTZ).
  • Introduce SETTINGS_BACKEND=file|db (default: file for backwards compatibility).
  • When SETTINGS_BACKEND=db:
    • Bootstrap loads overrides from PostgreSQL on startup.
    • If the table is empty, import existing settings.yaml / legacy settings.json once.
    • Admin settings PATCH and restore persist overrides to the DB.
    • Runtime settings = shipped defaults merged with DB overrides.

Out of scope (follow-ups)

  • DB-mode backup snapshots on each PATCH file mode still creates timestamped YAML backups.
  • Hot-reload of DB overrides across all cluster workers after admin changes.
  • Refactoring compose, bootstrap copied files so operators never edit release-owned files.
  • Full settings schema migration, versioning in the DB.
Linguagem predominante
TypeScript
Estrelas
829
Forks
234
Merge médio
4d 5h
PRs com merge (30d)
22

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de cameri/nostream

Todas as issues de cameri/nostream

Issues semelhantes

Mais issues de TypeScript

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.