> ## 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.

# murmur workspace build-image

> Start the Configure environment service that builds a workspace's custom image and keeps it current.

Starts automatic image setup for an existing [workspace](https://docs.murmur.dev/concepts/workspaces.md). The **Configure environment** service builds and verifies a custom [image](https://docs.murmur.dev/concepts/images.md), updates the workspace to use it, and maintains it afterward according to the workspace's access settings.

[`murmur workspace create`](https://docs.murmur.dev/cli/workspace-create) starts this service automatically. Use `build-image` if that step failed or you skipped it with `--skip-image`.

When the service is already running in the workspace, the request is queued to it.

## Synopsis

```bash theme={null}
murmur workspace build-image NAME
```

## Arguments

| Name | Type | Required | Description |
| - | - | - | - |
| `NAME` | string | yes | The workspace whose image to build. |

The workspace's **Configure environment** access setting controls which changes the service can make. It runs under the `murmur-image-updater` service profile. See [Choosing what the service may do](https://docs.murmur.dev/concepts/recipe.md#choosing-what-the-service-may-do).

## Example

```bash theme={null}
murmur workspace build-image api
```

## Errors

| Code | Meaning | What to do |
| - | - | - |
| `a workspace name is required; an empty NAME names no workspace` | `NAME` is an empty string, such as an unset shell variable in quotes. | Pass the workspace's name. |
| `flight murmur-configure-environment is disabled for this tenant (re-enable: murmur set flight murmur-configure-environment)` | The service is disabled for your tenant. | Re-enable it with `murmur set flight murmur-configure-environment`. |
| `daemon identity must match an enabled daemon Flight and its service profile` | The service was disabled before the agent started. | Re-enable it with `murmur set flight murmur-configure-environment`. |

## Related

* [`murmur workspace create`](https://docs.murmur.dev/cli/workspace-create): create a workspace
* [Customize your Workspace](https://docs.murmur.dev/customize-your-workspace.md): how the custom image is built
* [`murmur director --persona murmur-baker`](https://docs.murmur.dev/cli/director): build an image interactively


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.