CoderLuii/HolyClaude

HolyClaude – Quick‑start AI‑dev workstation in a Docker container

What it is – HolyClaude is a ready‑made Docker image that bundles the official Claude Code CLI (Anthropic’s coding assistant) together with a full‑stack development environment:

• a web UI (CloudCLI) for interacting with Claude
• a headless Chromium browser + Xvfb + Playwright for screenshots and UI testing
• 8 AI‑CLI tools (Claude, OpenAI Codex, Gemini, Cursor, TaskMaster, Junie, OpenCode, Pi) pre‑installed
• 50+ common dev utilities (Node 26, Python, Git, database clients, etc.)
• process supervision via s6‑overlay
• multi‑arch images (amd64 & arm64) and a slimmer variant for low‑disk environments.

The whole stack is containerised, so you avoid the usual “install Claude, fix Chromium, set up Xvfb, configure permissions” nightmare. Just docker compose up and you have an always‑on Linux workstation that works with any existing Anthropic subscription (Max/Pro) or API key.

---

Quick start (30 s)

mkdir holyclaude && cd holyclaude
cat > docker-compose.yaml <<'EOF'
services:
  holyclaude:
    image: coderluii/holyclaude:latest
    container_name: holyclaude
    restart: unless-stopped
    shm_size: 2g
    ports:
      - "127.0.0.1:3001:3001"
    volumes:
      - ./data/claude:/home/claude/.claude   # persists auth & Claude memory
      - ./workspace:/workspace               # your code
    environment:
      - TZ=UTC
EOF

docker compose up -d

Open http://localhost:3001, create a CloudCLI account, sign‑in with your Anthropic credentials and you’re ready to code with Claude.

---

Why use HolyClaude?

Feature	HolyClaude	Manual setup
Claude Code	Pre‑installed, works out‑of‑the‑box	Install, debug installer, fix permissions
Web UI	CloudCLI bundled, no extra wiring	Find & configure a UI yourself
Headless browser	Chromium + Xvfb + Playwright, shm = 2 GB	Install each piece, tune shared memory, sandbox settings
AI CLIs	8 providers ready (Claude, Codex, Gemini, …)	Install each CLI separately
Dev tools	Node, Python, Git, DB clients, etc.	Manual apt/npm/pip installs
Process supervision	s6‑overlay auto‑restart	Write your own supervisord config
Persistence	Bind‑mounted ./data/claude keeps credentials & Claude memory across rebuilds
Multi‑arch	amd64 & arm64 images; works on Raspberry Pi, NAS, cloud VMs
Updates	docker compose pull && docker compose up -d	Update dozens of tools manually

In short, HolyClaude removes the “works on my machine” friction and gives you a reproducible, always‑on AI development box.

---

Image variants

Tag	Contents	When to pick
latest (full)	All tools pre‑installed – zero‑wait for Claude commands
slim	Core runtime only; missing tools are installed on‑demand – smaller download
X.Y.Z / X.Y.Z‑slim	Pinned releases for production stability

Both variants are available for amd64 and arm64; size is shown on Docker Hub.

---

Authentication & cost

• Claude Max/Pro – sign‑in via the CloudCLI UI (OAuth) – you pay exactly what you already pay to Anthropic.
• Anthropic API key – paste the key in the UI – pay‑per‑use as usual.
• No credential relay: the container reads keys from files, bind‑mounts or environment variables and contacts the providers directly.
• Other AI CLIs (Gemini, OpenAI Codex, Cursor, etc.) work similarly with their own API keys.

---

Extending / customizing

• Full compose template (see README) exposes many optional ports (Next.js, Vite, Cloudflare Workers, SSH, etc.) and lets you override paths via .env.
• Remote access – instead of exposing ports, the guide recommends Tailscale or Cloudflare Tunnel for secure external access.
• Ollama – a section explains how to run local LLMs alongside HolyClaude.
• Building locally – you can rebuild the image from source if you need a custom toolchain.

---

Known limits & roadmap

• Kubernetes support is “coming soon” (Helm chart planned).
• The current release (v1.6.4) includes an accepted‑risk security manifest for known CVEs in the custom FFmpeg build and other bundled binaries.
• Future work: tighter container hardening, optional GPU support, and a Helm chart for K8s.

---

Getting help

• Open an issue on GitHub.
• Join the community on X (formerly Twitter) @CoderLuii.
• Donate via PayPal or Buy Me A Coffee if you find it useful.

---

Bottom line: HolyClaude is a genuine, open‑source project that packages a full Claude‑based AI development workstation into a single Docker image, dramatically cutting down setup time and eliminating the usual Docker‑related gotchas.