Managing Collections

List, enable, disable, and delete collections using the Bluebricks app or the Bricks CLI

Overview

Manage the lifecycle of your collections through the Bluebricks app or the bricks collection CLI commands. You can list all collections, check their status, and enable, disable, or delete them as your infrastructure needs change.

To create a new collection, see Creating Collections. For the conceptual overview, see Collections.

How to list collections

Bluebricks app

Open the Collections page in the Bluebricks app. The table shows all active collections with their cloud provider, cloud account, and latest deployment status. Use the filters to narrow results by status or provider.

CLI

Status indicators

Indicator	Meaning
DEFAULT	Collection is the default target when --collection is omitted
INACTIVE	Collection is disabled
deployment-name (stage)	Most recent deployment and its current stage (running, completed, failed)
-	No deployments in this collection

Collection states

State	Description
Active	Collection is enabled and ready for deployments
Inactive	Collection is disabled; enable it before deploying
Default	Collection is the default target for bricks install when no --collection flag is specified

How to enable a collection

Reactivate a disabled (locked) collection so it can receive deployments again.

Bluebricks app

1. Open the Collections page

2. Click the three-dot menu on the inactive collection

3. Click Unlock

4. Confirm in the dialog

CLI

How to disable a collection

Disable (lock) a collection to prevent new deployments. Existing infrastructure is not affected.

Bluebricks app

• Open the Collections page

• Click the three-dot menu on the collection

• Click Lock

• Confirm in the dialog

CLI

Disabling a collection does not destroy deployed resources. It only prevents new deployments from targeting this collection.

How to delete a collection

Permanently remove a collection.

Bluebricks app

1. Open the Collections page

2. Click the three-dot menu on the collection

3. Click Delete

4. Review the list of associated deployments and confirm

CLI

Deleting a collection is irreversible. Make sure all environments in the collection have been destroyed or archived before deleting.

How to set a default collection

The default collection is used when you run bricks install without specifying --collection.

Bluebricks app

1. Open the Collections page

2. Click the three-dot menu on the collection

3. Click Set as Default

4. Confirm in the dialog

CLI

How to clone a collection

Duplicate an existing collection with its configuration.

Using the app

1. Open the Collections page

2. Click the three-dot menu on the collection

3. Click Clone

4. Confirm in the dialog