Name: HolyCode
Author: CoderLuii

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. Use whatever model you want.

Provider	Environment Variable
Anthropic Claude	ANTHROPIC_API_KEY
OpenAI	OPENAI_API_KEY
Google Gemini	GEMINI_API_KEY
Groq	GROQ_API_KEY
AWS Bedrock	AWS_ACCESS_KEY_ID + 2 more
Azure OpenAI	AZURE_OPENAI_ENDPOINT + 2 more

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

Why This Exists

I built this because I was tired of re-doing the same setup every time.

	HolyCode	DIY
Setup	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."

- CoderLuii

HolyCode