HolyClaude: One-Command AI Coding Workstation
Stop wasting hours configuring Claude Code, web UIs, headless browsers, and 50+ dev tools. HolyClaude delivers a complete AI development workstation in one Docker command. Includes Claude Code CLI, CloudCLI web UI, Chromium+Playwright, 7 AI CLIs (Claude, Gemini, OpenAI, Cursor), Node.js/Python environments, and git/gh. Works with your existing Anthropic subscription. Runs on Linux, macOS, Windows, ARM64, even NAS devices. Just 'docker compose up -d' and build at http://localhost:3001.
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
| Platform | Status | Notes |
|---|---|---|
| Linux amd64 | ✅ | Recommended |
| Linux arm64 | ✅ | Pi 4+, Oracle Cloud |
| macOS | ✅ | Docker Desktop |
| Windows | ✅ | WSL2 + Docker |
| Synology/QNAP | ✅ | NAS ready |
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
| Tag | Size | Best for |
|---|---|---|
:latest |
Full | Zero wait time |
:slim |
Lean | VPS, metered bandwidth |
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.