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 |
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.
codesphere.experiments is the deprecated name of codesphere.internal. The
installer still reads both and merges them. Use internal.
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: cimg-private-registry, openfga-authz, preview-comments, privileged-ports,
secret-management, static-landscapes, sub-path-mount, tcp-udp, team-container-registries, workspace-ssh.
secret-management additionally requires OpenBao to be installed and configured
(see openBao). Enabling the flag without it leaves
secret management non-functional with no error at install time.
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.