Name: HolyClaude
Author: CoderLuii

Quick Start

From zero to AI coding in 30 seconds. No, really.

1

Create a folder

$ mkdir holyclaude && cd holyclaude

2

Create a `docker-compose.yaml`

docker-compose.yaml

services:
  holyclaude:
    image: coderluii/holyclaude:latest
    container_name: holyclaude
    hostname: holyclaude
    restart: unless-stopped
    shm_size: 2g                  # Chromium needs this
    network_mode: bridge
    cap_add:
      - SYS_ADMIN              # Chromium sandboxing
      - SYS_PTRACE             # Debugging tools
    security_opt:
      - seccomp=unconfined     # Chromium in Docker
    ports:
      - "127.0.0.1:3001:3001"  # CloudCLI web UI, localhost only
    volumes:
      - ./data/claude:/home/claude/.claude
      - ./workspace:/workspace
    environment:
      - TZ=UTC
      # Optional: Apprise notifications (100+ services)
      # - NOTIFY_DISCORD=discord://webhook_id/webhook_token

3

Launch it

$ docker compose up -d

4

Open the Web UI

Open http://localhost:3001

Create a CloudCLI account, sign in with your Anthropic account, and build something.

That's the whole setup. You're done. No .env files. No pre-configuration. No reading 40 pages of docs.

What You Get

Every tool Claude needs. Pre-installed. Pre-configured. Zero wait time.

Claude Code CLI

The real deal. Anthropic's official CLI, pre-installed and ready to go.

CloudCLI Web UI

CloudCLI 1.34.0 on port 3001, patched for UTF-8 Web Terminal output, sessions, projects, and plugins.

8 AI CLIs

Claude Code, Gemini CLI, OpenAI Codex, Cursor, TaskMaster AI, Junie, OpenCode, and Pi Coding Agent.

Headless Chromium

Chromium + Playwright pre-configured. shm, sandbox, seccomp — all solved.

50+ Dev Tools

Git, Node.js, Python, GitHub CLI, ripgrep, fzf, bat, jq, tmux, htop, and dozens more.

s6-overlay

Real process supervision. Auto-restart, graceful shutdown, clean logs. Not a hack.

Multi-arch

AMD64 + ARM64. Intel, AMD, Apple Silicon, Graviton. It just runs.

Bind Mount Persistence

Your code lives on your host. Claude auth and session state survive container rebuilds.

Apprise Notifications

Walk away and know when Claude is done. Discord, Telegram, Slack, Email, and 100+ services.

Desloppify

desloppify ships in both images and stays passive unless you run it or set HOLYCLAUDE_DESLOPPIFY_SETUP.

Why This Exists

Because you've already spent a weekend debugging Chromium in Docker.

	HolyClaude	Doing it yourself
Setup	30 seconds	1-2 hours (if it goes well)
Claude Code	Pre-installed, pre-configured	Install, configure, debug installer hanging
Web UI	CloudCLI included with plugins	Find one, install it, wire it up
Browser	Chromium + Playwright, configured	Fix shm, fix sandbox, fix seccomp...
Dev tools	50+ tools, ready	apt-get / npm / pip for the next hour
Updates	compose pull && up	Update 50 tools, pray nothing breaks

"I got tired of re-doing the same Docker setup every time — installing Claude Code, wiring up a web UI, fixing Chromium's shm/sandbox/seccomp, debugging permissions. So I containerized all of it and hit every bug so you don't have to."

— CoderLuii

Pick Your Size

Two flavors. Same quality. Pick your weight class.

RECOMMENDED

Latest

Full image. Batteries included. Node.js, Python, all 8 AI CLIs, deployment tools, PDF libs, data viz. Docker Hub reports about 4.1 GB compressed.

$ docker pull coderluii/holyclaude

MINIMAL

Slim

Core tools only. Claude installs extras on-demand. Docker Hub reports about 2.4 GB compressed. NAS tools can show larger unpacked sizes.

$ docker pull coderluii/holyclaude:slim

Need pinned tags? Use 1.3.7 for full or 1.3.7-slim for slim.

Your Account, Your Keys

This runs the real Claude Code CLI. Not a wrapper. Not a proxy. Not a knock-off.

Works

✓
Claude Max/Pro plan — Sign in through CloudCLI. Same OAuth flow as desktop.
✓
Anthropic API key — Set it in the web UI. Pay-per-use, same billing.

Codex

✓
ChatGPT Plus/Pro/Team/Enterprise — Works with OpenAI Codex through codex login --device-auth.
✓
Callback port — Expose 127.0.0.1:1455:1455 only when you need the browser callback flow.

Other Tools Included

Five AI CLIs ship in both images. The full image adds Junie, OpenCode, and Pi.

Gemini CLIAPI key

OpenAI CodexAPI key or login

CursorAPI key

TaskMaster AItask runner

JunieJetBrains account

OpenCodeOpenRouter path

Pi Coding Agentpi command

Desloppify ships too, as a passive scan CLI. It is not counted as one of the 8 AI CLIs.

CloudCLI is patched inside the image. Update with docker compose pull && docker compose up -d, not cloudcli update or npm install -g @cloudcli-ai/cloudcli@latest.

HolyClaude is free and open source. You only pay your AI providers for usage, same as you already do. We don't proxy, intercept, or touch your credentials.

Missing a Tool?

HolyClaude is built from real requests. Open a package request with the tool name, install method, and target image.

Request a Package

Open a GitHub issue — tell us what tool or library you need and why.

Alternatives

HolyClaude vs. every other way to run AI coding agents.

	HCHolyClaude	DockerVanilla Docker	DevconDevcontainer	BareBare Metal
Setup	1 cmd	DIYWrite Dockerfile	ConfigConfig + VS Code	Manual
CLIsAI CLIs	8	DIY	SomeVia features	DIY
Web UI	Yes	No	VS CodeVS Code only	No
Browser	Ready	Hard	Hard	Native
IsolateIsolation	Full	Full	Full	No
Arch	Both	DIY	MaybeDepends	Native

HolyClaude