Skip to content

Document the {{ secret.* }} compose-template secret feature (follow-up to freeshard#138) #7

Description

@ClaydeCode

Follow-up to FreeshardBase/freeshard#138 (inject shard-specific secrets into app compose templates).

Once #138 lands, document the secrets mechanism wherever compose-template variables / app_meta.json are described, so app authors know it exists:

  • Syntax: {{ secret.my-secret }} in an app's docker-compose template. Names are arbitrary; each distinct name yields one app-scoped secret.
  • Generation: auto-generated on install, 32 chars from upper+lower+digits.
  • Storage: persisted in the DB, scoped to shard + app.
  • Lifecycle: kept across uninstall and upgrade (no rotation/regeneration for now).
  • At rest: not encrypted (current scope).

Add a short copy-pasteable example app template using a generated secret (e.g. a DB password).

🤖 Generated with Claude Code

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions