Version: Weekly Build
Codesphere Feature Flags
Codesphere organizes flags into two maturity levels, each configured differently in your config.yaml:
| Bucket | Config Key | Purpose |
|---|---|---|
| Features | codesphere.features | Long-lived, stable capabilities that can be toggled per installation |
| Preview | codesphere.experiments | Less mature or riskier opt-in features; stable API not yet guaranteed |
warning
Preview flags may change or be removed in future releases. Use with care in production environments.
Feature Flags
Feature flags control long-lived, stable capabilities of your Codesphere installation. Configure them under codesphere.features as a map of boolean values.
| Flag | Description | Default (Private Cloud) |
|---|---|---|
billing | Enables billing features for workspace and hosting plans. | false |
avatar-upload | Allows users to upload a custom profile avatar. Requires GCloud Storage | false |
dev-domains-port | Enables port-based routing for development domains. | false |
email-signup | Allows users to register with an email address. | false |
email-signin | Allows users to sign in with an email address. | false |
run-as-root-insecure | Allows workspaces to run as root. Security risk — only use in trusted environments. | false |
standalone-teams | Allows teams to exist outside of an organization. When disabled, every team must belong to an organization. See Organizations & Teams for more context. | false |
Example:
codesphere:
features:
email-signup: true
email-signin: true
billing: false
standalone-teams: false
Preview Flags
Preview flags enable less mature or riskier customer-facing features. They are opt-in and require explicit enablement. For now, preview flags can be set via the experiments config as a list of flag names to enable.
| Flag | Description |
|---|---|
privileged-ports | Allows workspaces to listen on privileged ports in the range [0..1024). |
secret-management | Enables the secret management feature for workspaces. |
sub-path-mount | Enables sub-path volume mounting in workspaces. |
tcp-udp | Enables TCP/UDP port exposure for workspaces beyond standard HTTP/HTTPS. |
ws-vscode-server | Enables VS Code Server integration inside workspaces. |
Example:
codesphere:
# Preview flags are enabled by adding them to the experiments list.
experiments:
- privileged-ports
- ws-vscode-server
Full Example
The following shows all three flag buckets configured together:
codesphere:
# ... other settings ...
# Long-lived feature flags
features:
email-signup: true
email-signin: true
billing: false
standalone-teams: false
# Preview flags — add flag names to enable them
# Use with care!
experiments:
- privileged-ports