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

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions