# Bluebricks

## Docs

- [Welcome to the Bluebricks Docs](https://bluebricks.co/docs/readme.md): Get an overview of Bluebricks' core concepts, tools, and how they work together
- [What is Bluebricks?](https://bluebricks.co/docs/getting-started/building-blocks.md): Learn what Bluebricks is, how the context layer enables safe agentic infrastructure, and how orchestration fits in
- [Quick Start](https://bluebricks.co/docs/getting-started/quick-start.md): Connect your cloud and code, then talk to the Bluebricks agent to discover and manage your infrastructure
- [Connect your Cloud](https://bluebricks.co/docs/getting-started/connect-your-cloud.md): Connect your cloud accounts so Bluebricks can discover your resources and build the context layer that powers the agent
- [Connecting to AWS](https://bluebricks.co/docs/getting-started/connect-your-cloud/how-to-connect-aws.md): Step-by-step guide to connect an AWS account to Bluebricks using a CloudFormation stack
- [Connecting to Azure](https://bluebricks.co/docs/getting-started/connect-your-cloud/how-to-connect-azure.md)
- [Connecting to GCP](https://bluebricks.co/docs/getting-started/connect-your-cloud/how-to-connect-gcp.md): Step-by-step guide to connect a Google Cloud project to a Bluebricks collection, grant discovery permissions, and start cloud resource ingestion
- [Kubernetes Integration](https://bluebricks.co/docs/getting-started/connect-your-cloud/kubernetes-integration.md): How Bluebricks discovers managed Kubernetes clusters through your cloud connections and indexes live cluster state for the agent and context layer.
- [Connect your Code](https://bluebricks.co/docs/getting-started/connect-your-code.md): Connect your infrastructure code repositories so the Bluebricks agent can read your IaC, answer questions about it, and propose changes through pull requests
- [Agent Overview](https://bluebricks.co/docs/agent/agents-overview.md): How the Bluebricks agent uses the context layer to discover, secure, and manage your infrastructure
- [Integration threads](https://bluebricks.co/docs/agent/integration-threads.md): Shared agent conversations created from alerts and webhooks so your team can investigate incidents together.
- [Codifying Infrastructure](https://bluebricks.co/docs/agent/codifying-infrastructure.md): Import unmanaged cloud resources into infrastructure code through the Bluebricks agent
- [Agent Governance](https://bluebricks.co/docs/agent/governance.md): How approval flows, collection policies, and role-based access control work when managing infrastructure through the agent
- [Reading a Bluebricks PR](https://bluebricks.co/docs/agent/reading-a-bluebricks-pr.md): Understand the structured PR format that the Bluebricks agent uses when opening pull requests for infrastructure changes
- [Tips for Working with the Agent](https://bluebricks.co/docs/agent/prompting-best-practices.md): How to write effective prompts for the Bluebricks agent
- [Orchestration Overview](https://bluebricks.co/docs/orchestration/orchestration.md): Manage infrastructure through the Bluebricks platform UI and CLI with governed deployment pipelines.
- [Orchestration Quick Start](https://bluebricks.co/docs/orchestration/orchestration-quick-start.md): Create your first collection, blueprint, and environment using the Bluebricks orchestration platform.
- [Collections](https://bluebricks.co/docs/orchestration/collections.md): A collection is a logical unit for provisioning cloud infrastructure
- [Creating Collections](https://bluebricks.co/docs/orchestration/collections/create-an-environment.md): Create collections from the Bluebricks app or CLI to organize infrastructure by team, project, or lifecycle stage
- [Managing Collections](https://bluebricks.co/docs/orchestration/collections/managing-collections.md): List, enable, disable, and delete collections using the Bluebricks app or the Bricks CLI
- [Owners and Members](https://bluebricks.co/docs/orchestration/collections/owners-and-members.md): Control who can access and govern your collections by assigning owners and members
- [Properties](https://bluebricks.co/docs/orchestration/collections/properties.md): Adapt reusable blueprints to a specific collection with key-value properties
- [Secrets](https://bluebricks.co/docs/orchestration/collections/secrets.md): Store and manage sensitive values like API keys and credentials at the collection level
- [Policies](https://bluebricks.co/docs/orchestration/collections/policies.md): Define approval workflows, cost limits, and allowed blueprints to govern how environments operate within a collection
- [Packages](https://bluebricks.co/docs/orchestration/packages.md): Packages are the reusable building blocks of Bluebricks
- [Blueprints](https://bluebricks.co/docs/orchestration/packages/blueprints-overview.md): Blueprints are reusable templates that compose infrastructure stacks
- [Creating Blueprints](https://bluebricks.co/docs/orchestration/packages/blueprints-overview/creating-blueprints.md): Combine multiple packages into a reusable, deployable infrastructure blueprint
- [From Code to Blueprint](https://bluebricks.co/docs/orchestration/packages/blueprints-overview/from-code-to-blueprint.md): Turn existing Infrastructure as Code into a reusable Bluebricks blueprint you can deploy, version, and share across teams
- [Using expr](https://bluebricks.co/docs/orchestration/packages/blueprints-overview/expr.md): Use the expr expression language in bricks.json for dynamic configuration, conditional logic, string operations, and runtime property references
- [Blueprint Composition Patterns](https://bluebricks.co/docs/orchestration/packages/blueprints-overview/blueprint-composition-patterns.md): Common patterns for composing blueprints, managing package dependencies, and structuring outputs effectively
- [Local Development](https://bluebricks.co/docs/orchestration/packages/blueprints-overview/local-development.md): Test and iterate on blueprints locally using bricks run before deploying to cloud environments
- [Publish with bricks.yaml](https://bluebricks.co/docs/orchestration/packages/blueprints-overview/publish-with-bricks-yaml.md): Publish blueprints using bricks.yaml for simplified syntax, auto-populated fields, multi-document support, and YAML-native features
- [Artifacts](https://bluebricks.co/docs/orchestration/packages/artifacts-overview.md): Artifacts wrap your existing IaC code into versioned, reusable building blocks
- [Creating Artifacts via CLI](https://bluebricks.co/docs/orchestration/packages/artifacts-overview/creating-artifacts.md): Create reusable Infrastructure as Code artifacts in Bluebricks to standardize infrastructure and enable consistent deployments across environments
- [Terraform/OpenTofu](https://bluebricks.co/docs/orchestration/packages/artifacts-overview/terraform-open-tofu.md): Terraform and OpenTofu: understand managed state, input/output, and versioned rollouts
- [Publish a Terraform Module](https://bluebricks.co/docs/orchestration/packages/artifacts-overview/terraform-open-tofu/publish-terraform-module.md): Convert an existing Terraform module into a Bluebricks package using the prepare and publish CLI workflow
- [Helm](https://bluebricks.co/docs/orchestration/packages/artifacts-overview/helm.md): Helm reference: chart lifecycle, Kubernetes authentication, release tracking, and input/output
- [CRD Management](https://bluebricks.co/docs/orchestration/packages/artifacts-overview/helm/helm-crd-management.md): How Bluebricks automatically handles Custom Resource Definitions (CRDs) in Helm charts using server-side apply for reliable, consistent deployments
- [CloudFormation](https://bluebricks.co/docs/orchestration/packages/artifacts-overview/cloudformation.md): CloudFormation reference: parameter mapping, outputs capture, and AWS authentication
- [Generic](https://bluebricks.co/docs/orchestration/packages/artifacts-overview/generic.md): Generic artifact reference: run any containerized task as a one-shot Kubernetes Job
- [Container Configuration](https://bluebricks.co/docs/orchestration/packages/artifacts-overview/generic/container-config.md): Configure Docker containers for Generic artifacts: image selection, commands, environment variables, and approved registries
- [Lifecycle and Execution](https://bluebricks.co/docs/orchestration/packages/artifacts-overview/generic/lifecycle.md): How Generic artifacts execute across deployment stages, with per-stage configuration and smart execution caching
- [Bicep](https://bluebricks.co/docs/orchestration/packages/artifacts-overview/bicep.md): Bicep reference: deployment modes, parameter mapping, outputs capture, and Azure authentication
- [Deployment Modes](https://bluebricks.co/docs/orchestration/packages/artifacts-overview/bicep/bicep-deployment-modes.md): Choose between Complete and Incremental deployment modes for Bicep artifacts based on resource group ownership
- [.bricksignore](https://bluebricks.co/docs/orchestration/packages/artifacts-overview/.bricksignore.md): Exclude large or unnecessary files from published packages using a .bricksignore file, similar to .gitignore pattern format.
- [Inputs & Outputs](https://bluebricks.co/docs/orchestration/packages/inputs-and-outputs.md): How inputs and outputs define the interface of every package in Bluebricks
- [Environments](https://bluebricks.co/docs/orchestration/environments.md): An environment is the workflow that provisions, updates, and destroys infrastructure by executing a blueprint against a target collection
- [Creating Environments](https://bluebricks.co/docs/orchestration/environments/creating-environments.md): Create environments from the Bluebricks app or CLI to deploy blueprints into collections
- [GitOps Environments](https://bluebricks.co/docs/orchestration/environments/gitops-environments.md): Automatically trigger infrastructure plans and deployments from Git pushes
- [Archiving Environments](https://bluebricks.co/docs/orchestration/environments/archiving-environments.md): Remove environments from your active list without affecting deployed infrastructure
- [Automatic Drift Detection](https://bluebricks.co/docs/orchestration/environments/drift-detection.md): Detect when infrastructure state diverges from the desired blueprint configuration
- [Time to Live (TTL)](https://bluebricks.co/docs/orchestration/environments/environment-ttl.md): Define how long an environment should be up and running
- [Runs](https://bluebricks.co/docs/orchestration/runs.md): Plan and apply infrastructure changes through runs
- [Monitoring Runs](https://bluebricks.co/docs/orchestration/runs/monitoring-runs.md): Track run progress and status from the Bluebricks app or CLI
- [Destroying Environments](https://bluebricks.co/docs/orchestration/runs/destroying-environments.md): Uninstall an environment to destroy all infrastructure resources it provisioned
- [Promoting Environments](https://bluebricks.co/docs/orchestration/runs/promoting-environments.md): Promote an environment run to another collection with the same blueprint and inputs
- [State Management and History](https://bluebricks.co/docs/orchestration/runs/state-management-and-history.md): Track infrastructure state safely across environments and teams
- [Environment Manifest File Format](https://bluebricks.co/docs/orchestration/runs/deployment-manifest-file-format.md): Declarative YAML format for defining environment state, used in CI/CD pipelines and Git-based infrastructure workflows
- [Using Outputs References](https://bluebricks.co/docs/orchestration/runs/using-outputs-references.md): Use the outputs of one environment as inputs for another to compose modular, cross-layer infrastructure architectures
- [Using Context References](https://bluebricks.co/docs/orchestration/runs/using-context-references.md): Insert dynamic references to environment and collection metadata in property values, resolved automatically at runtime
- [Parallel Execution](https://bluebricks.co/docs/orchestration/runs/parallel-execution.md): How Bluebricks executes blueprint packages in parallel based on their dependencies
- [Cloud Graph](https://bluebricks.co/docs/orchestration/cloud-graph.md): Get a comprehensive understanding of the cloud graph
- [Webhooks](https://bluebricks.co/docs/orchestration/webhooks.md): Configure webhook callbacks to receive real-time notifications for environment events like creation, updates, and status changes
- [Best Practices](https://bluebricks.co/docs/orchestration/bluebricks-git-repository-guide.md): Best practices for using Git repositories as the primary driver for infrastructure modifications with Bluebricks
- [Git Repository Folder Structure](https://bluebricks.co/docs/orchestration/bluebricks-git-repository-guide/git-repository-folder-structure.md): Recommended folder structure for managing Bluebricks artifacts, blueprints, and environment configurations in a Git repository
- [Getting Started with Bricks Action](https://bluebricks.co/docs/orchestration/bluebricks-git-repository-guide/getting-started-with-bricks-action.md): Set up the Bricks GitHub Action to run CLI commands in GitHub workflows for automated version bumping, publishing, and deployment
- [Managing Infrastructure-as-Code on Git](https://bluebricks.co/docs/orchestration/bluebricks-git-repository-guide/managing-infrastructure-as-code-on-git.md): Automate blueprint version bumping, publishing, and updates through Git-based CI workflows using Bricks Action
- [Managing Configuration on Git](https://bluebricks.co/docs/orchestration/bluebricks-git-repository-guide/managing-configuration-on-git.md): Use declarative environment files and PR-based workflows to manage infrastructure provisioning through Git with Bricks Action
- [Day 2 Operations](https://bluebricks.co/docs/managing-infrastructure/managing-infrastructure.md): Update deployed infrastructure by changing blueprint inputs and re-running environments in Bluebricks
- [Scaling Compute Resources](https://bluebricks.co/docs/managing-infrastructure/managing-infrastructure/scaling-compute-resources.md): Update CPU, memory, and VM sizes for deployed workloads by changing blueprint inputs and re-running environments
- [Managing Storage](https://bluebricks.co/docs/managing-infrastructure/managing-infrastructure/managing-storage.md): Resize disks, change disk types, and manage storage for deployed environments by updating blueprint inputs
- [Scaling Kubernetes Clusters](https://bluebricks.co/docs/managing-infrastructure/managing-infrastructure/scaling-kubernetes-clusters.md): Scale Kubernetes cluster nodes, add node pools, and configure autoscaling by updating blueprint inputs and re-running environments
- [Temporary Scaling](https://bluebricks.co/docs/managing-infrastructure/managing-infrastructure/temporary-scaling.md): Scale infrastructure temporarily for testing or load evaluation, then revert or promote the change using Bluebricks environments
- [Bricks CLI Overview](https://bluebricks.co/docs/bricks-cli/bricks-cli.md): Install and configure the bricks CLI for macOS, Linux, or Windows to manage collections, blueprints, and environments from the command line
- [CLI Authentication](https://bluebricks.co/docs/bricks-cli/authentication.md): Authenticate the bricks CLI with your Bluebricks account using browser-based login or long-lived tokens for CI/CD
- [Authenticate Using Long-Lived Tokens](https://bluebricks.co/docs/bricks-cli/authentication/authenticate-using-long-lived-tokens.md): Configure long-lived API tokens for CLI authentication in scripts, CI/CD pipelines, and automation workflows
- [Configuration Management](https://bluebricks.co/docs/bricks-cli/configuration-management.md): Understand how the Bricks CLI stores and loads configuration from ~/.bricks, including config.yaml, credentials.yaml, environment variables, and global flags
- [Telemetry](https://bluebricks.co/docs/bricks-cli/telemetry.md): Understand what telemetry data Bluebricks collects from the CLI and web app, and how to opt out
- [CLI Reference](https://bluebricks.co/docs/bricks-cli/cli-reference.md): Complete reference for every bricks CLI command
- [bricks blueprint](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_blueprint.md)
- [add](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_blueprint/bricks_blueprint_add.md)
- [add-repo](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_blueprint/bricks_blueprint_add-repo.md)
- [bump](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_blueprint/bricks_blueprint_bump.md)
- [create](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_blueprint/bricks_blueprint_create.md)
- [tf](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_blueprint/bricks_blueprint_create/bricks_blueprint_create_tf.md)
- [describe](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_blueprint/bricks_blueprint_describe.md)
- [fetch](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_blueprint/bricks_blueprint_fetch.md)
- [get](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_blueprint/bricks_blueprint_get.md)
- [outs](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_blueprint/bricks_blueprint_get/bricks_blueprint_get_outs.md)
- [props](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_blueprint/bricks_blueprint_get/bricks_blueprint_get_props.md)
- [init](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_blueprint/bricks_blueprint_init.md)
- [prepare](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_blueprint/bricks_blueprint_prepare.md)
- [publish](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_blueprint/bricks_blueprint_publish.md)
- [remove](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_blueprint/bricks_blueprint_remove.md)
- [search](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_blueprint/bricks_blueprint_search.md)
- [state-config](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_blueprint/bricks_blueprint_state-config.md)
- [status](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_blueprint/bricks_blueprint_status.md)
- [update](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_blueprint/bricks_blueprint_update.md)
- [view](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_blueprint/bricks_blueprint_view.md)
- [bricks clouds](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_clouds.md)
- [delete](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_clouds/bricks_clouds_delete.md)
- [ls](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_clouds/bricks_clouds_ls.md)
- [bricks collection](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_collection.md)
- [create](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_collection/bricks_collection_create.md)
- [delete](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_collection/bricks_collection_delete.md)
- [disable](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_collection/bricks_collection_disable.md)
- [enable](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_collection/bricks_collection_enable.md)
- [ls](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_collection/bricks_collection_ls.md)
- [bricks deploy](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_deploy.md)
- [list](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_deploy/bricks_deploy_list.md)
- [bricks install](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_install.md)
- [bricks login](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_login.md)
- [bricks logout](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_logout.md)
- [bricks run](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_run.md)
- [bricks setup](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_setup.md)
- [bricks uninstall](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_uninstall.md)
- [bricks updateci](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_updateci.md)
- [bricks version](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_version.md)
- [bricks whoami](https://bluebricks.co/docs/bricks-cli/cli-reference/bricks_whoami.md)
- [Slack](https://bluebricks.co/docs/integrations/slack.md): Talk to the Bluebricks agent from Slack, get rich link previews, and approve runs without leaving your workspace
- [Github](https://bluebricks.co/docs/integrations/github.md): Connect GitHub repositories to Bluebricks for GitOps environments, plan check runs, and agent-powered infrastructure changes
- [Github Actions](https://bluebricks.co/docs/integrations/githubactions.md): Run Bricks CLI commands in GitHub Actions workflows to automate blueprint publishing, deployment, and CI/CD pipelines
- [GitLab](https://bluebricks.co/docs/integrations/gitlab.md): Run Bluebricks CLI commands inside GitLab CI/CD pipelines to automate infrastructure deployments and package management
- [Azure DevOps](https://bluebricks.co/docs/integrations/azure-devops.md): Integrate bricks CLI into Azure DevOps pipelines
- [Backstage](https://bluebricks.co/docs/integrations/backstage.md): Integrate Bluebricks with Backstage to let developers provision environments, browse blueprints, and manage infrastructure from the developer portal
- [Bluebricks MCP](https://bluebricks.co/docs/integrations/bricks-mcp.md): Use the Bluebricks MCP server to let AI agents provision, plan, and deploy cloud infrastructure through natural language
- [Claude Code Plugin](https://bluebricks.co/docs/integrations/claude-code-plugin.md): Use the Bluebricks plugin for Claude Code to deploy blueprints, create packages, and manage environments from your terminal
- [Bluebricks Docs for AI Agents](https://bluebricks.co/docs/integrations/docs-for-agents.md): Give AI agents access to Bluebricks documentation through llms.txt and context files
- [Account Settings](https://bluebricks.co/docs/organization-and-security/account-settings.md): View your profile, manage users, configure webhooks, and access integrations
- [Roles and Permissions](https://bluebricks.co/docs/organization-and-security/roles-and-permissions.md): Understand permissions for each role in your account
- [Setup Single-Sign-On (SSO)](https://bluebricks.co/docs/organization-and-security/setup-single-sign-on-sso.md): Customer Setup Instructions
- [Security at Bluebricks](https://bluebricks.co/docs/organization-and-security/security-at-bluebricks.md)
- [Bluebricks Self Hosted Runner](https://bluebricks.co/docs/organization-and-security/bluebricks-self-hosted-runner.md): Deploy the Bluebricks Deployments Controller (BDC) as a Kubernetes operator to run IaC tasks in your own cloud account
- [BDC Helm Chart](https://bluebricks.co/docs/organization-and-security/bluebricks-self-hosted-runner/bdc-helm-chart.md): Helm chart values reference for deploying the Bluebricks Deployments Controller (BDC) to your Kubernetes cluster
- [Orchestrator in a Box](https://bluebricks.co/docs/organization-and-security/bluebricks-self-hosted-runner/orchestrator-in-a-box.md): Deploy the Bluebricks Self-Hosted Runner on a single VM using K3s and Docker, ideal for lightweight or evaluation setups
- [Registration and Authentication](https://bluebricks.co/docs/organization-and-security/bluebricks-self-hosted-runner/registration-and-authentication.md): How the self-hosted runner registers with Bluebricks and uses Kubernetes JWTs for passwordless, secure task orchestration
- [Using a Self-Hosted Cloud](https://bluebricks.co/docs/organization-and-security/bluebricks-self-hosted-runner/what-is-a-self-hosted-cloud.md): Connect any cloud account or on-premise setup to Bluebricks using the self-hosted runner for full infrastructure orchestration
- [Network Access Requirements](https://bluebricks.co/docs/organization-and-security/netwrok-access-requirements.md): Required domains, IP addresses, and ports that must be accessible for Bluebricks to function properly in your network

## API reference

- [Bluebricks API Overview](https://bluebricks.co/docs/api/readme.md)
- [API Authentication](https://bluebricks.co/docs/api/authenticate/authentication.md)
- [Auth](https://bluebricks.co/docs/api/reference/auth.md)
- [Cloud Accounts](https://bluebricks.co/docs/api/reference/cloud-accounts.md)
- [Collections](https://bluebricks.co/docs/api/reference/collections.md)
- [Envs](https://bluebricks.co/docs/api/reference/envs.md)
- [Git Repositories](https://bluebricks.co/docs/api/reference/git-repositories.md)
- [Graph](https://bluebricks.co/docs/api/reference/graph.md)
- [Organization](https://bluebricks.co/docs/api/reference/organization.md)
- [Package](https://bluebricks.co/docs/api/reference/package.md)
- [Rescue](https://bluebricks.co/docs/api/reference/rescue.md)
- [Setup](https://bluebricks.co/docs/api/reference/setup.md)
- [Status](https://bluebricks.co/docs/api/reference/status.md)
- [Tasks](https://bluebricks.co/docs/api/reference/tasks.md)
- [Users](https://bluebricks.co/docs/api/reference/users.md)
- [Webhooks](https://bluebricks.co/docs/api/reference/webhook.md)
- [Webhooks Inbound](https://bluebricks.co/docs/api/reference/webhooks-inbound.md)
- [Deployments (Deprecated)](https://bluebricks.co/docs/api/reference/deployments.md)
- [Environments (Deprecated)](https://bluebricks.co/docs/api/reference/environments.md)

## Help

- [Bluebricks Help Center](https://bluebricks.co/docs/help/readme.md): Start here for Bluebricks help. Browse troubleshooting guides, FAQs, or contact support
- [Authentication](https://bluebricks.co/docs/help/troubleshooting/authentication.md): Resolve login failures, expired tokens, API key issues, and collection access errors with the Bricks CLI and Bluebricks app
- [Deployments & Runs](https://bluebricks.co/docs/help/troubleshooting/deployments.md): Resolve environment not found errors, slug conflicts, stuck runs, approval blocks, and lock issues during deployments
- [Packages & Blueprints](https://bluebricks.co/docs/help/troubleshooting/packages.md): Resolve publishing errors, invalid bricks.json files, output reference issues, and other package and blueprint problems
- [Cloud Connections](https://bluebricks.co/docs/help/troubleshooting/cloud-connections.md): Resolve cloud account connection issues for AWS, Azure, GCP, and self-hosted infrastructure
- [Self-Hosted Runner](https://bluebricks.co/docs/help/troubleshooting/self-hosted-runner.md): Resolve common issues with the Bluebricks Deployments Controller (BDC) and Bricks Runner, including OOMKilled jobs, stuck tasks, and storage errors
- [Develop Terraform Locally](https://bluebricks.co/docs/help/guides/develop-terraform-locally.md): How to run Terraform or OpenTofu locally when you need to debug or inspect remote state managed by Bluebricks
- [Migrate Terraform State to Bluebricks](https://bluebricks.co/docs/help/guides/migrate-terraform-state.md): How to migrate an existing Terraform deployment into Bluebricks when you want to adopt Bluebricks without recreating infrastructure

## Changelog

- [June 2026](https://bluebricks.co/docs/changelog/readme.md): Bluebricks Release Notes
- [May 2026](https://bluebricks.co/docs/changelog/may-2026.md): Bluebricks Release Notes
- [April 2026](https://bluebricks.co/docs/changelog/april-2026.md): Bluebricks Release Notes
- [March 2026](https://bluebricks.co/docs/changelog/march-2026.md): Bluebricks release notes
- [February 2026](https://bluebricks.co/docs/changelog/february-2026.md): Bluebricks release notes
- [January 2026](https://bluebricks.co/docs/changelog/january-2026.md): Bluebricks release notes
- [December 2025](https://bluebricks.co/docs/changelog/december-2025.md): Bluebricks release notes
- [November 2025](https://bluebricks.co/docs/changelog/november-2025.md): Bluebricks release notes
- [October 2025](https://bluebricks.co/docs/changelog/october-2025.md): Bluebricks release notes
