HolyClaude: The Ultimate One-Command AI Development Workstation

Stop Configuring. Start Building.

You've spent hours (or days) fighting Docker permissions, Chromium shared memory limits, Claude Code installer hangs, and permission-denied errors. HolyClaude solves every single one.

One command gets you: - ✅ Claude Code CLI (your existing Max/Pro subscription works) - ✅ CloudCLI web UI (http://localhost:3001) - ✅ Headless Chromium + Xvfb + Playwright (screenshots, testing, Lighthouse) - ✅ 7 AI CLIs: Claude, Gemini, OpenAI Codex, Cursor, Junie, TaskMaster, OpenCode - ✅ 50+ dev tools: Node.js 22, Python 3, pnpm, git/gh, ripgrep, 100+ npm/pip packages - ✅ Multi-arch: AMD64 + ARM64 (Raspberry Pi, Apple Silicon, AWS Graviton)

mkdir holyclaude && cd holyclaude
# Copy docker-compose.yaml from repo
 docker compose up -d
# Open http://localhost:3001

That's it. Your Anthropic auth works through the web UI OAuth flow. No extra costs. MIT licensed. 1.7k GitHub stars.

Why HolyClaude Exists

Manual setup = 2+ hours of pain: - Chromium crashes (shm_size=64MB → 2GB fix) - Permission denied (PUID/PGID mismatch) - Claude installer hangs (WORKDIR root-owned) - SQLite locks on NAS mounts - File watchers broken on SMB shares

HolyClaude = 30 seconds of docker compose up. Every edge case handled.

What's Inside (Full Image)

AI CLIs (switch with one Tab): Claude, Gemini, Codex, Cursor, Junie, TaskMaster, OpenCode

Languages & Build Tools: - Node.js 22 + pnpm + TypeScript + Vite + esbuild - Python 3 + pandas/numpy + FastAPI + requests

Browser Automation: Chromium + Xvfb(:99) + Playwright (pre-configured)

Deployment: Vercel, Netlify, Cloudflare Workers, Azure CLI

Data Processing: PDF generation (7 libraries), Excel/Word/PowerPoint, ffmpeg, pandoc

System: git/gh, ripgrep/fd/fzf, tmux, htop, psql/redis-cli

Quick Start (Copy-Paste Ready)

Create docker-compose.yaml:

services:
  holyclaude:
    image: coderluii/holyclaude:latest
    container_name: holyclaude
    restart: unless-stopped
    shm_size: 2g
    cap_add:
      - SYS_ADMIN
      - SYS_PTRACE
    security_opt:
      - seccomp=unconfined
    ports:
      - "3001:3001"
    volumes:
      - ./data/claude:/home/claude/.claude
      - ./workspace:/workspace
    environment:
      - TZ=UTC

docker compose up -d
open http://localhost:3001  # Sign in with Anthropic

Use Your Existing Subscription

Claude Max/Pro: Web UI OAuth (same as desktop app) API Key: Paste in settings No extra cost - HolyClaude is free OSS

Other providers work too: - OpenAI/ChatGPT: codex login --device-auth - Gemini: GEMINI_API_KEY - Cursor: CURSOR_API_KEY

Platform Support

Production Ready

• Persistence: ./data/claude (credentials), ./workspace (code)
• Process supervision: s6-overlay (auto-restart, graceful shutdown)
• Updates: docker compose pull && docker compose up -d
• Permissions: PUID/PGID mapping
• Notifications: Discord/Telegram/Slack/Email (Apprise)

Slim vs Full Images

Slim auto-installs missing packages. Full has everything pre-built.

Built by Daily Users

"This is what I run every day on my server." - CoderLuii

1.7k ⭐ 190 forks. MIT License. Actively maintained.

GitHub Repo - Star it, fork it, build with it.

Stop fighting Docker. Start shipping code.