🏗️ Create

In a nutshell

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

Runner, bot, and MCP Bundle creation are available:

# Register and start a GitLab runner from ACORN configuration
acorn create runner

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

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

# Package the running executable
acorn create mcp

# Package a release binary and update an authoring Kitfile
acorn create mcp --binary ./acorn --platform linux --kitfile ./Kitfile

Runner creation supports Docker, Podman, and Apptainer selection with --runtime. Runner containers always start detached. A remote Docker daemon can be selected with --host or configured per runner with target.host; volumes then belong to the remote host. See the full runner configuration for a config-only example.

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

create mcp emits a deterministic MCPB archive. Use --dry-run to inspect the manifest and inventory, --clobber to replace an existing regular file, and --output to select its destination. External binaries require an explicit --platform darwin|linux|win32; Windows inputs must end in .exe. See MCP Bundles for the manifest, trust, and release contract.

Next stop: Run the bot you created with Serve.