# Welcome to the Bluebricks Docs

## Get started

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-type="image">Cover image (dark)</th><th data-hidden data-card-cover-dark data-type="image">Cover image (dark)</th></tr></thead><tbody><tr><td><strong>What is Bluebricks?</strong><br>Learn how Bluebricks leverages your IaC to standardize how infrastructure is defined, approved, and executed</td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2Fsj0sNcXR3DeCF03DwCZk%2Fwhat%20is%20bluebricks%20light.png?alt=media&#x26;token=13bac6b1-b295-470e-ac7d-9c41a7a2533e">what is bluebricks light.png</a></td><td><a href="getting-started/building-blocks">building-blocks</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FYnsJ3WIpWCt5HO2w0PCE%2Fwhat%20is%20bluebricks%20dark.png?alt=media&#x26;token=452384b5-1701-4322-be67-b668d367d428">what is bluebricks dark.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FYnsJ3WIpWCt5HO2w0PCE%2Fwhat%20is%20bluebricks%20dark.png?alt=media&#x26;token=452384b5-1701-4322-be67-b668d367d428">what is bluebricks dark.png</a></td></tr><tr><td><strong>Quick Start</strong><br>Get started by packaging IaC into a reusable blueprint then deploying it from an environment</td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FYA9ZUL5lKj3JvCWjxNUY%2FQuick%20Start%20light.png?alt=media&#x26;token=6ce2a5d3-01ee-4d1d-85f0-780259eb62f1">Quick Start light.png</a></td><td><a href="getting-started/quick-start">quick-start</a></td><td></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FRESwdrd8T6v6O2nrpgEg%2FQuick%20Start%20dark.png?alt=media&#x26;token=fdaf58b8-69a7-4e30-8ea4-c140e2329079">Quick Start dark.png</a></td></tr></tbody></table>

## Get to know Bluebricks

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-cover-dark data-type="image">Cover image (dark)</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Collections</strong><br>See how collections group cloud accounts, teams, and stages</td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2F58jJtWsUBBovyIBOiJoU%2Fimage.png?alt=media&#x26;token=fba49bfd-0923-41e0-8220-b3156043953b">image.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FrVRdcMTf8nTIx3BtZRU6%2Fimage.png?alt=media&#x26;token=218634c8-52f2-4ef0-aa67-8174a4f2197b">image.png</a></td><td><a href="core-concepts/collections">collections</a></td></tr><tr><td><strong>Packages</strong><br>Get to know the packages that are reused, versioned, and shared</td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FeqLMCpo4YS6vMBSTdPQf%2Fimage.png?alt=media&#x26;token=a44920f5-98b9-4fe4-9553-36efed6371c9">image.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FrggOt4jR7QR3E9BRVRlM%2Fimage.png?alt=media&#x26;token=85164da8-eeea-4886-b23c-9cdb92c761ba">image.png</a></td><td><a href="core-concepts/packages">packages</a></td></tr><tr><td><strong>Environments</strong><br>Explore the environments where infrastructure is deployed and run</td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2Fhxyv9Iz8iirKnhja8imq%2Fimage.png?alt=media&#x26;token=142b3427-91a5-4de6-825e-6be425fa23f4">image.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2Fo8CWi9ar6esUgbHbLGoj%2Fimage.png?alt=media&#x26;token=b0613cce-4d38-42a8-9faf-390572ffdfcd">image.png</a></td><td><a href="core-concepts/environments">environments</a></td></tr><tr><td><strong>Bluebricks Agent</strong><br>Learn how to manage your infrastructure through conversation</td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2F0Da4FXzH5wAcxvkYzEVu%2Fagent%20light.png?alt=media&#x26;token=6053d380-3b57-4d25-a02a-4b11d3ffdf98">agent light.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FZt6pSLCeJv1Zl8ZMZ7Zz%2Fagent%20dark.png?alt=media&#x26;token=3f407c33-9a02-4978-a9c0-2af94f2f8dc8">agent dark.png</a></td><td><a href="agentic-infrastructure/bluebricks-agent">bluebricks-agent</a></td></tr><tr><td><strong>Discovery</strong><br>See how Bluebricks helps you know what's actually running in your cloud</td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2F9q8wT4VsDZsps0jLvAH0%2Fmcp%20light.png?alt=media&#x26;token=fb85b83a-beb3-40fc-abcc-af6d16c8d6f4">mcp light.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FEMjcGRkdX91KHy10JHPp%2Fmcp%20dark.png?alt=media&#x26;token=87a659a7-6b52-4d19-a219-08293421e04c">mcp dark.png</a></td><td><a href="core-concepts/discovery">discovery</a></td></tr><tr><td><strong>GitOps Environments</strong><br>Learn how to keep your cloud in sync with your code</td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FUCCiKL7fdn9DpJl7Oyq3%2Fgitops%20env%20light.png?alt=media&#x26;token=08e64765-e82a-4f14-a2f3-236f2b3320a9">gitops env light.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FBPYsWz8mhX9Avix3EIy5%2Fgitops%20env%20dark.png?alt=media&#x26;token=6e66aa2a-66ac-49f7-b6a7-90f8c197b393">gitops env dark.png</a></td><td><a href="core-concepts/environments/gitops-environments">gitops-environments</a></td></tr></tbody></table>

## Your IaC and Bluebricks

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-type="image">Cover image (dark)</th><th data-hidden data-card-cover-dark data-type="image">Cover image (dark)</th></tr></thead><tbody><tr><td><strong>Blueprints</strong><br>Blueprints are reusable templates that describe the infrastructure needed to create an environment</td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FLRBrfnIaLqBaOaEfuBaT%2FGroup%201597882133.png?alt=media&#x26;token=4d340e42-3a39-457c-8715-96a67dc6a8b6">Group 1597882133.png</a></td><td><a href="core-concepts/packages/blueprints-overview">blueprints-overview</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FELdPGmpIJiaW723UlguJ%2FGroup%2048.png?alt=media&#x26;token=af895212-e26b-4334-ba1b-18d3c6cb4d80">Group 48.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FELdPGmpIJiaW723UlguJ%2FGroup%2048.png?alt=media&#x26;token=af895212-e26b-4334-ba1b-18d3c6cb4d80">Group 48.png</a></td></tr><tr><td><strong>Inputs and Outputs</strong><br>Inputs let you customize how a blueprint runs, and outputs show the important values created after it finishes</td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2F89072lirlFaw799OWQfu%2FInputs%20and%20outputs%20light.png?alt=media&#x26;token=420220b4-0c82-44ec-9828-43eb054a81f5">Inputs and outputs light.png</a></td><td><a href="core-concepts/packages/inputs-and-outputs">inputs-and-outputs</a></td><td></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FVHCfnqvSpmfkRoB92e55%2FInputs%20and%20outputs%20dark.png?alt=media&#x26;token=5d10b320-40ae-4b38-bd85-1127a0668c34">Inputs and outputs dark.png</a></td></tr></tbody></table>

### Turn IaC into reusable artifacts

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><img src="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FzUHrNFVLaYG6Qq37I9BI%2Fimage.png?alt=media&#x26;token=6b93432c-4f31-438d-8aa6-dc0842517084" alt="" data-size="original"></td><td><strong>Bluebricks</strong> <strong>Artifacts</strong><br>Wrap and reuse a single IaC component that is deployed in a blueprint</td><td><a href="core-concepts/packages/artifacts-overview">artifacts-overview</a></td></tr><tr><td><img src="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2F2Mshr4U0If8tGuGJwwsA%2Fimage.png?alt=media&#x26;token=f9c2ac07-0b1f-4860-99a0-bf1c12847d93" alt="" data-size="original"></td><td><strong>OpenTofu &#x26; Terraform</strong><br>Define, plan, provision infrastructure resources declaratively with Terraform or OpenTofu</td><td><a href="core-concepts/packages/artifacts-overview/terraform-open-tofu">terraform-open-tofu</a></td></tr><tr><td><img src="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FSucAjPRr0xuXQ0Ihq0te%2Fimage.png?alt=media&#x26;token=40f4b0d6-f493-44c5-bfb7-0fa5b930e857" alt="" data-size="original"></td><td><strong>Helm</strong><br>Deploy and manage Kubernetes applications using standard Helm charts</td><td><a href="core-concepts/packages/artifacts-overview/helm">helm</a></td></tr><tr><td><img src="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2F2kyOr9Z8dU22ITAH4i5g%2Fimage.png?alt=media&#x26;token=0448b0cf-63ad-481e-aebf-532de44df11f" alt="" data-size="original"></td><td><strong>CloudFormation</strong><br>Manage AWS infrastructure using native CloudFormation templates</td><td><a href="core-concepts/packages/artifacts-overview/cloudformation">cloudformation</a></td></tr><tr><td><img src="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FbqE63hlAp4JTEPEojwP8%2Fimage.png?alt=media&#x26;token=ba76b064-092a-4a23-aa01-1313371986ad" alt="" data-size="original"></td><td><strong>Bicep</strong><br>Describe Azure resources declaratively using the Bicep language</td><td><a href="core-concepts/packages/artifacts-overview/bicep">bicep</a></td></tr><tr><td><img src="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FsBPkPBqRtWh3m3T5R6CG%2Fimage.png?alt=media&#x26;token=a5896f48-d766-45f1-b4c5-a7d382598676" alt="" data-size="original"></td><td><strong>Generic artifacts</strong><br>Extend Bluebricks orchestration beyond native IaC tools with generic artifacts</td><td><a href="core-concepts/packages/artifacts-overview/generic">generic</a></td></tr></tbody></table>

## Explore more features

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-type="image">Cover image (dark)</th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover-dark data-type="image">Cover image (dark)</th></tr></thead><tbody><tr><td><strong>Connect your cloud</strong><br>Map your clouds to deploy infrastructure securely</td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2F246vi5T5OQW9gB7OEjcT%2Fimage.png?alt=media&#x26;token=a1a9c8a2-df70-418a-8b40-78c247db9bd0">image.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FsdvDqEGrOr9dUoZvtAW5%2Fimage.png?alt=media&#x26;token=8f67c044-30c2-4524-95fb-90766beea7f5">image.png</a></td><td><a href="core-concepts/collections/connect-your-cloud">connect-your-cloud</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FsdvDqEGrOr9dUoZvtAW5%2Fimage.png?alt=media&#x26;token=8f67c044-30c2-4524-95fb-90766beea7f5">image.png</a></td></tr><tr><td><strong>Runs</strong><br>Plan and apply infrastructure changes through runs</td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FWADPmarao15xZnleRJHN%2Fruns.png?alt=media&#x26;token=20251ea9-9410-4a83-a96f-e14e5bcd932d">runs.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2F2FeLaRHnGuzl1r5CMUqO%2Fimage.png?alt=media&#x26;token=b9d00e99-7407-4e9d-95e8-4e465fe83df8">image.png</a></td><td><a href="core-concepts/runs">runs</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FJHiGKehBCE20LIFBpvBu%2Fruns%20dark.png?alt=media&#x26;token=8b4dbcd9-e463-4e9a-9ca0-523430b8190c">runs dark.png</a></td></tr><tr><td><strong>Drift detection</strong><br>Automatically detect when infrastructure state diverges</td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2Fo7P5rPQku4BelTvkh3O2%2Fimage.png?alt=media&#x26;token=eec20f31-de2e-4b86-9e00-c8b3a3e7ce7e">image.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2F0HaYk6X4VqrPir52pqhn%2Fimage.png?alt=media&#x26;token=044ca5be-0ed8-4b6b-a50f-2482368230e4">image.png</a></td><td><a href="core-concepts/environments/drift-detection">drift-detection</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2F0HaYk6X4VqrPir52pqhn%2Fimage.png?alt=media&#x26;token=044ca5be-0ed8-4b6b-a50f-2482368230e4">image.png</a></td></tr></tbody></table>

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-cover-dark data-type="image">Cover image (dark)</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Codification</strong><br>Use the Cloud Import Agent to codify your existing infrastructure</td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FD36akLNV2DOIiKUAVWzt%2Fimage.png?alt=media&#x26;token=7ba31021-b6b3-4903-b725-05f64d93e16d">image.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FjkyLYUmjgPIe20saoOeR%2Fimage.png?alt=media&#x26;token=2bfef311-dcde-4a81-ae47-3f7448de5039">image.png</a></td><td><a href="core-concepts/cloud-graph/cloud-import-agent">cloud-import-agent</a></td></tr><tr><td><strong>Bluebricks CLI</strong><br>Run, plan, and ship infrastructure with Bricks CLI</td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FRNjAfd7n4475I9qBBcaL%2Fimage.png?alt=media&#x26;token=46bbdbb0-ac8a-4667-9b05-594d48eb7fbf">image.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2F4Pc9fdgtMWsjUOvFIIfZ%2Fimage.png?alt=media&#x26;token=28d7ca17-89c2-4b05-80f4-ab3da71c8074">image.png</a></td><td><a href="bricks-cli">bricks-cli</a></td></tr><tr><td><strong>API Overview</strong><br>Explore the Bluebricks API to integrate and automate at scale</td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2Fy34wq3aA8oXfIJqhr77O%2Fimage.png?alt=media&#x26;token=0cfb8581-7205-4428-b984-4d1798d923da">image.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FDsOvQlx42jhdu2ORAyWv%2Fimage.png?alt=media&#x26;token=fa05b640-1ea7-4667-983d-4bed9b875607">image.png</a></td><td><a href="https://app.gitbook.com/o/iKUEpOu0rHJgw5e0pXke/s/qHXqMr0KYQT5OUP6gSt0/">API references</a></td></tr></tbody></table>
