Feature Flags
Codesphere organizes flags into three buckets in config.yaml:
| Bucket | Config key | Type | Purpose |
|---|---|---|---|
| Features | codesphere.features | map of flag name to true/false | Long-lived, stable capabilities that can be toggled per installation |
| Preview | codesphere.preview | map of flag name to true/false | Less mature or riskier opt-in features; stable API not yet guaranteed |
| Internal | codesphere.internal | list of flag names | Codesphere-internal flags, not intended for customer use |
warning
Preview and internal flags may change or be removed in future releases. Use with
care in production environments, and prefer stable features flags where possible.
Known discrepancy
The install configuration schema defines codesphere.internal as a list of flag
names. However, the installer that validates flags at deploy time currently reads
its internal-flag list from a codesphere.experiments key instead, not
codesphere.internal. Confirm with Codesphere which key applies to your installer
version before relying on an internal flag being enabled end to end.
Feature flags
Configure stable, long-lived capabilities under codesphere.features as a map of
boolean values:
codesphere:
features:
email-signup: true
email-signin: true
billing: false
standalone-teams: false
Known feature flags: avatar-upload, billing, dev-domains-port, email-signin,
email-signup, run-as-root-insecure, standalone-teams.
Preview flags
Configure opt-in, less mature capabilities under codesphere.preview as a map of
boolean values:
codesphere:
preview:
secret-management: true
workspace-ssh: true
Known preview flags: openfga-authz, preview-comments, privileged-ports,
secret-management, sub-path-mount, tcp-udp, workspace-ssh.
Internal flags
codesphere.internal is a list of flag names for Codesphere-internal use. Do not
enable an internal flag in a customer installation without explicit guidance from
Codesphere — see the discrepancy note above.