Environments

Learn more about environments in Bucket

What are environments?

An environment is an instance of an app that is specified by a group of shared parameters or servers. Environments are usually used to isolate a production app from testing, however, they can also differentiate multiple single-tenant deployments of the same app.

Bucket has three default environments: Production, Staging, and Development.

You can add, edit, and delete as many additional environments as you’d like.

All environments except Production can be edited or deleted at any time.

Getting started

  • When you create your account, there are three default environments: Production, Staging, and Development.

  • Go to Settings

  • Under App: [Your App Name], click Environments

  • Fetch your unique publishable keys and/or secret keys to implement with an SDK or HTTP API.

    • This key is essential for integrating your applications with our platform. It ensures that events and data are attributed to the correct environment.

Bucket Environments

Managing environments

Create a new environment

To create a new environment:

  • Head to the Settings page

  • Select the Environments menu item listed App: [Your App Name]

  • Click the + New environment button and give a name for your new environment.

    • If needed, you can rename the environment later

  • After clicking the Create button, the new environment will appear in the list alongside its associated publishable key and secret key.

Environments after adding a new environment
Environments after adding "Pre-Production"

The Production environment cannot be deleted or edited. New environments can be edited or deleted at any time.

Switching Between Environments

You can switch between environments by:

  • Click the app switcher interface in the top-left corner of the browser

  • Click on an environment listed below the application's name to switch to that environment

  • When a non-Production environment is active, it will be displayed under the current application's name in the app switcher.

Switching between environments

Environment settings

There are three levels of settings in Bucket:

  • Organization: Contains the organization-wide settings

  • App: [Your App Name]: Contains the application-wide settings

  • Environment: [Name]: Contain environment-specific settings for the current application.

Application-wide functionalities

When you're configuring application-wide settings, environments aren't applicable.

The following entities and configuration options are application-wide and not dependent on an environment:

  • Feature Views: They're application-wide except for their Slack Reporting settings,

  • Company Segments: They are shared across all environments. However, the companies in these segments will vary across environments.

Production environment-based functionalities

There are environment-specific functionalities that are only allowed in the Production environment. These are:

  • Slack: Reporting settings in Features and Feature views can be configured from any environment, but are also reflected in the Production environment

  • Some configuration sections are disabled if the selected environment is not Production.

Some settings are Production environment-only and are disabled when a non-Production environment is active.

Environment-based functionalities

All other settings and functionalities are environment-specific. Anything that requires data to be sent from the clients is inherently environment-specific. This includes:

Last updated

Was this helpful?