> ## Documentation Index
> Fetch the complete documentation index at: https://docs.murmur.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Placements

> Where your agent VMs run — cloud account, region, VPC network, and credentials that let Murmur boot machines on GCP, AWS, or Docker.

A placement determines which cloud account and region your [agents](/concepts/agents) run in.

## Platform and customer placements

Every tenant starts with **platform placements** — preconfigured by Murmur, available immediately, no setup required. Your [workspace](/concepts/workspaces) references one by name and agents run on Murmur-managed infrastructure.

**Customer placements** are optional. You create one when you need agents running in your own GCP project or AWS account — for VPC-internal access to databases and APIs, data residency requirements, or compliance policies that require compute in your cloud. The [customer placements guide](/guides/customer-placements) walks through the full setup.

Both kinds work the same way once configured. The difference is who owns the cloud account the VMs run in.

## How placements connect to other resources

A [workspace](/concepts/workspaces) references one placement and one [environment](/concepts/environments). The placement controls *where* — cloud account, region, network. The [environment](/concepts/environments) controls *what size* — machine type and disk. These are independent: you can reuse the same environment across multiple placements of the same cloud provider.

[Images](/concepts/images) are bound to placements. A VM image baked in one GCP project or AWS account is not visible from another. When you create a customer placement, you re-bake your [recipes](/concepts/recipe) against it so the resulting images exist in your cloud account.

***

| Type      | Page                                               |
| --------- | -------------------------------------------------- |
| Guide     | [Customer placements](/guides/customer-placements) |
| Reference | [placement](/catalog/placement)                    |
| Concept   | [Workspaces](/concepts/workspaces)                 |
| Concept   | [Environments](/concepts/environments)             |
| Concept   | [Images](/concepts/images)                         |
| Concept   | [Recipes](/concepts/recipe)                        |