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