Feature Flags

Page last updated: December 23, 2015

Feature flags are switches that you set using the Cloud Controller API. They allow an administrator to turn on or off functional sections of code, or features, of an application without deploying new code. Use feature flags to enable or disable features available to users.

Feature Flags

There are nine feature flags that you can set. They are all enabled by default except user_org_creation and diego_docker. When disabled, these features are only available to administrators.

  • user_org_creation: Any user can create an organization via the API. minimum CC API version: 2.12
  • private_domain_creation: An organization 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

Feature Flag Commands

Get All Feature Flags

cf feature-flags

Get status of a Feature Flag

cf feature-flag FEATURE_FLAG_NAME

Enable a Feature Flag

cf enable-feature-flag FEATURE_FLAG_NAME

Disable a Feature Flag

cf disable-feature-flag FEATURE_FLAG_NAME

To view the feature flag commands, review the Feature Flags section of the Cloud Foundry API documentation.