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

# Rig environment presets

> Choose a prebuilt Amika environment for a rig.

A preset selects the prebuilt environment that boots a rig. The hosted platform
resolves it to the appropriate provider image or snapshot.

## Available presets

### `coder` (default)

Use `coder` for most repositories.

* Base: Ubuntu 24.04
* Tools: Git, GitHub CLI, curl, zsh, build essentials, Python, Node.js 24,
  `npm`, `pnpm`, TypeScript, and `tsx`
* Agent CLIs: Claude Code, Codex, OpenCode, and Pi
* Amika tools: `amika`, `amikalog`, and `amikad`

### `coder-plus-docker`

Use `coder-plus-docker` when a repository needs Docker inside the rig, such as
for Docker Compose or containerized development services.

It includes everything in `coder`, plus Docker Engine and Buildx. It does not
support the `xs` size tier.

## Select a preset

Pass `--preset` to override a repository default for one rig:

```bash theme={null}
amika rig create --preset coder
amika rig create --preset coder-plus-docker
```

Set a default for every hosted rig created from a repository:

```toml theme={null}
[sandbox]
preset = "coder-plus-docker"
size = "m"
```

If no request or repository setting selects a preset, Amika uses `coder`.

## Inspect installed versions

Preset versions change as Amika publishes new environments. Check the running
rig instead of depending on a fixed patch version:

```bash theme={null}
for tool in git gh node npm pnpm python3 claude codex opencode pi docker; do
  if command -v "$tool" >/dev/null 2>&1; then
    printf '%s: ' "$tool"
    "$tool" --version 2>/dev/null | head -n 1 || true
  fi
done
```

## Setup scripts

Both presets support repository setup and start scripts. The hosted platform
reads each configured script from the repository and installs it as a lifecycle
hook. The source file's executable bit in Git is not required.

See [Rig configuration](https://docs.amika.dev/reference/rig-configuration.md#lifecycle-scripts) and the
[`[lifecycle]` reference](https://docs.amika.dev/guides/config-toml#lifecycle).

## Agent credentials

Hosted rigs receive selected Claude and Codex credentials from Amika's remote
credential store. Push credentials before creating the rig:

```bash theme={null}
amika secret claude push --type oauth
amika secret codex push --type oauth
```

Use `[agent_credentials]` or the `--agent-credential` flags to select a stored
credential. See [Inject credentials](https://docs.amika.dev/guides/inject-credentials.md).

## Reserved ports

Preset environments reserve ports 60899 through 60999 for Amika services. See
[Reserved ports](https://docs.amika.dev/reference/rig-configuration.md#reserved-ports).

## Related docs

* [Rig configuration](https://docs.amika.dev/reference/rig-configuration.md)
* [config.toml reference](https://docs.amika.dev/guides/config-toml.md)
* [CLI reference](https://docs.amika.dev/reference/cli.md)


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