Skip to main content
Version: Weekly Build

Feature Flags

Codesphere organizes flags into three buckets in config.yaml:

BucketConfig keyTypePurpose
Featurescodesphere.featuresmap of flag name to true/falseLong-lived, stable capabilities that can be toggled per installation
Previewcodesphere.previewmap of flag name to true/falseLess mature or riskier opt-in features; stable API not yet guaranteed
Internalcodesphere.internallist of flag namesCodesphere-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.

note

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.