🏗️ Create

In a Nutshell

Create an ACORN-backed runner or bot with acorn create <RESOURCE>.

Runner and bot creation are available:

# Register and start a GitLab runner from ACORN configuration
acorn create runner --config ./.acorn.json

# Create a runner directly for a GitLab group
acorn create runner --group 12345 --name research-runner

# Create a detached bot container for a GitLab project
acorn create bot 12345 --detach

Runner creation supports Docker, Podman, and Apptainer selection with --runtime. A remote Docker daemon can be selected with --remote; volumes and published ports then belong to the remote host.

Run acorn create <resource> --help for the exact authentication, runtime, and network options.

The CLI currently lists acorn create mcp, but that path returns an explicit “not yet implemented” error. Use serve bot or the supported runner and bot creation paths above.

Next stop: Run the bot you created with Serve.