How can we help you?
Browse by topic
FAQs
What is the difference between an artifact and a blueprint?
An artifact is a single Infrastructure as Code (IaC) component: one Terraform module, one Helm chart, one CloudFormation template, one Bicep template, or one generic container. Artifacts are not directly deployable.
A blueprint is a deployable unit composed of one or more packages (artifacts or other blueprints). Blueprints define relationships between packages, wire inputs and outputs, and expose an interface to the deployer.
For the full explanation, see Packages.
What is the difference between a collection and an environment?
A collection is the target: it groups a cloud account, RBAC rules, properties, secrets, and policies into a single unit.
An environment is the workflow that deploys a blueprint to a collection. Each environment execution creates a run.
For details, see Collections and Environments.
What IaC tools does Bluebricks support?
Bluebricks supports five artifact types:
Terraform and OpenTofu (with version control and state management)
Helm (Kubernetes package manager)
CloudFormation (AWS native)
Bicep (Azure native)
Generic (any containerized workflow)
See the Artifacts Overview for details on each type.
How do I enable pre-release versions?
Pre-release package versions are disabled by default. Your organization admin can enable them in the organization settings. Once enabled, pre-release versions appear alongside stable versions when installing blueprints.
How do I check my CLI version and authentication status?
Run these two commands:
bricks --version shows the installed CLI version. bricks whoami confirms your current authentication status and user ID.
Can I use Bluebricks without Kubernetes?
Yes. Kubernetes is only required if you use the self-hosted runner (BDC) to execute deployments in your own infrastructure. Bluebricks also offers a managed runner option that does not require a Kubernetes cluster.
If you do need a lightweight Kubernetes setup, see Orchestrator in a Box for deploying K3s on a single VM.
How do I connect multiple cloud accounts?
Each collection connects to one cloud account. To manage multiple cloud accounts, create separate collections for each account. You can deploy the same blueprint across multiple collections, each targeting a different cloud account.
For setup instructions, see Connect your Cloud.
What are the network requirements for the self-hosted runner?
The Bluebricks Deployments Controller (BDC) requires outbound HTTPS access (port 443) to:
api.bluebricks.co(Bluebricks API)ghcr.io(container images)europe-docker.pkg.dev(Helm chart registry)Your cloud provider APIs (AWS, GCP, Azure)
No inbound ports need to be opened. For the full list of requirements, see Network Requirements.