Skip to main content
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:
Set a default for every hosted rig created from a repository:
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:

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 and the [lifecycle] reference.

Agent credentials

Hosted rigs receive selected Claude and Codex credentials from Amika’s remote credential store. Push credentials before creating the rig:
Use [agent_credentials] or the --agent-credential flags to select a stored credential. See Inject credentials.

Reserved ports

Preset environments reserve ports 60899 through 60999 for Amika services. See Reserved ports.

Open-source server images

The open-source amika-server uses generated Docker images named amika/coder:latest and amika/coder-plus-docker:latest. This local server implementation is separate from the hosted amika rig workflow.