Using Feature Flags
Page last updated:
This topic describes how Cloud Foundry (CF) administrators can set feature flags using the Cloud Foundry Command Line Interface (cf CLI) to enable or disable the features available to users.
To perform the following procedures, you must be logged in to your deployment as an administrator using the cf CLI.
cf feature-flagscommand to list the feature flags:
$ cf feature-flags Features State user_org_creation disabled private_domain_creation enabled app_bits_upload enabled app_scaling enabled route_creation enabled service_instance_creation enabled diego_docker disabled set_roles_by_username enabled unset_roles_by_username enabled task_creation enabled env_var_visibility enabled space_scoped_private_broker_creation enabled space_developer_env_var_visibility enabled service_instance_sharing disabled hide_marketplace_from_unauthenticated_users disabled
For descriptions of the features enabled by each feature flag, see the Feature Flags section below.
To view the status of a feature flag, use the
cf feature-flag FEATURE-FLAG-NAMEcommand:
$ cf feature-flag user_org_creation Retrieving status of user_org_creation as admin... OK Features State user_org_creation disabled
To enable a feature flag, use the
cf enable-feature-flag FEATURE-FLAG-NAMEcommand:
$ cf enable-feature-flag user_org_creation
To disable a feature flag, use the
cf disable-feature-flag FEATURE-FLAG-NAMEcommand:
$ cf disable-feature-flag user_org_creation
Only administrators can set feature flags.
All flags are enabled by default except
When disabled, these features are only available to administrators.
The following list provides descriptions of the features enabled or disabled by each flag, and the minimum Cloud Controller API (CC API) version necessary to use the feature. To determine your CC API version, follow the instructions in Identifying your Cloud Foundry API Endpoint and Version.:
user_org_creation: Any user can create an organization. Minimum CC API version: 2.12.
private_domain_creation: An Org Manager can create private domains for that organization. Minimum CC API version: 2.12.
app_bits_upload: Space Developers can upload app bits. Minimum CC API version: 2.12.
app_scaling: Space Developers can perform scaling operations (i.e. change memory, disk, or instances). Minimum CC API version: 2.12.
route_creation: Space Developers can create routes in a space. Minimum CC API version: 2.12.
service_instance_creation: Space Developers can create service instances in a space. Minimum CC API version: 2.12.
diego_docker: Space Developers can push Docker apps. Minimum CC API version 2.33.
set_roles_by_username: Org Managers and Space Managers can add roles by username. Minimum CC API version: 2.37.
unset_roles_by_username: Org Managers and Space Managers can remove roles by username. Minimum CC API version: 2.37.
task_creation: Space Developers can create tasks on their application. Minimum CC API version: 2.47.
env_var_visibility: All users can view environment variables. Minimum CC API version: 2.58.
space_scoped_private_broker_creation: Space Developers can create space-scoped private service brokers. Minimum CC API version: 2.58.
space_developer_env_var_visibility: Space Developers can view their v2 environment variables. Org Managers and Space Managers can view their v3 environment variables. Minimum CC API version: 2.58.
service_instance_sharing: Space Developers can share service instances between two spaces (across orgs) in which they have the Space Developer role.
hide_marketplace_from_unauthenticated_users: Do not allow unauthenticated users to see the service offerings available in the marketplace.
For more information about feature flag commands, see the Feature Flags section of the Cloud Foundry API documentation.
You can disable custom buildpacks for an entire deployment by setting the
cc.disable_custom_buildpacks property to
true in your Cloud Foundry deployment manifest. See the Deploying Cloud Foundry section for more information about creating and editing a manifest.