Quick Start

From zero to AI coding in under a minute.

Pull the image

$ docker pull coderluii/holycode:latest

Create a `compose.yaml`

compose.yaml

services:
  holycode:
    image: coderluii/holycode:latest
    container_name: holycode
    restart: unless-stopped
    shm_size: 2g                   # Chromium needs this
    ports:
      - "4096:4096"            # OpenCode web UI
    volumes:
      - holycode-config:/home/opencode/.config/opencode
      - holycode-data:/home/opencode/.local/share/opencode
      - holycode-state:/home/opencode/.local/state/opencode
      - holycode-cache:/home/opencode/.cache/opencode
      - ./workspace:/workspace
    environment:
      - ANTHROPIC_API_KEY=your-key-here

volumes:
  holycode-config:
  holycode-data:
  holycode-state:
  holycode-cache:

Start and open

$ docker compose up -d

Open http://localhost:4096. You're in.

What You Get

Everything you need. Nothing you don't.

OpenCode AI Agent

Built-in web UI on port 4096. Provider-agnostic. Bring any API key.

Persistent State

Settings, sessions, MCP configs, plugins. Named volumes. Rebuild without losing anything.

20+ Dev Tools

git, ripgrep, fzf, bat, eza, lazygit, delta, gh CLI, and more. Pre-installed.

Headless Browser

Chromium + Xvfb + Playwright. Screenshots, scraping, automation. Zero config.

Node.js 22 + Python 3

Two runtimes ready for your projects. npm, pip, venv included.

s6-overlay

Process supervision. Auto-restart. Clean shutdown. No zombies.

Any Provider. Your Choice.

OpenCode is provider-agnostic. Bring your own key, use any model.

Anthropic

ANTHROPIC_API_KEY

OpenAI

OPENAI_API_KEY

Gemini

GEMINI_API_KEY

Groq

GROQ_API_KEY

AWS Bedrock

3 env vars

Azure OpenAI

3 env vars

Set one key. Or set all of them. Switch providers anytime without rebuilding.

Why HolyCode

I built this because I was tired of re-doing the same setup every time. Installing OpenCode, configuring a headless browser in Docker, fixing UID permission issues, debugging process supervision. Every. Single. Time.

So I made a container that does all of it. And then I hit every possible bug so you don't have to.

HolyCode

DIY

Setup time

Under 2 minutes

30-60 minutes

Chromium + Xvfb

Pre-configured

Debug yourself

Dev tools

20+ pre-installed

Install one by one

State persistence

Automatic volumes

Manual bind mounts

UID/GID permissions

Built-in PUID/PGID

Dockerfile hacks

Multi-arch

amd64 + arm64

Build both yourself

Updates

docker pull

Rebuild from scratch

"The last row of every manual setup is 'works on my machine.' HolyCode works on every machine."