HolyClaude: Your Complete AI Coding Workstation in Docker

Stop configuring. Start building. HolyClaude is a pre-configured Docker container that gives you a complete AI coding environment in just 30 seconds. No more spending hours debugging Chromium in Docker, installing Claude Code, or wiring up web UIs. Just pull, run, and build.

What is HolyClaude?

HolyClaude is a Docker image created by CoderLuii that bundles everything you need for AI-assisted coding into a single container. After hitting every possible Docker + Claude Code bug while setting up his own environment, CoderLuii decided to containerize the entire experience so others wouldn’t have to go through the same frustrations.

The container includes Claude Code CLI, a web-based interface called CloudCLI, seven different AI coding agents, a headless Chromium browser with Playwright pre-configured, and over 50 development tools. Everything is pre-installed, pre-configured, and ready to work the moment you start the container.

Quick Start

Getting started takes less than a minute. Create a folder, add a docker-compose.yaml file, and run the container:

mkdir holyclaude && cd holyclaude

Create your docker-compose.yaml:

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

Then launch it:

docker compose up -d

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

What You Get

Claude Code CLI

The official Anthropic CLI, pre-installed and ready to go. Works with your existing Claude Max or Pro subscription, or use your Anthropic API key.

CloudCLI Web UI

A beautiful web interface on port 3001 with project management, multiple sessions, and plugins. Access Claude Code from any browser on your network.

7 AI CLIs

Claude Code, Gemini CLI, OpenAI Codex, Cursor, Junie, OpenCode, and TaskMaster AI. Switch between them instantly without leaving your container.

Headless Chromium

Chromium plus Playwright, fully configured with the correct shared memory settings, sandbox permissions, and seccomp profile. No more debugging Docker browser issues.

50+ Dev Tools

Git, Node.js, Python, GitHub CLI, ripgrep, fzf, bat, jq, tmux, htop, and dozens more. Every tool Claude might need is already there.

Process Supervision

Built on s6-overlay for real process management with auto-restart, graceful shutdown, and clean logs. Not a hacky supervisord configuration.

Why This Exists

The story behind HolyClaude is one many developers know too well. You want to use Claude Code, but you also need a web UI, a headless browser for testing, Playwright configured, every AI CLI available, TypeScript, Python, deployment tools, database clients, and GitHub CLI.

So you start installing things. One by one. Then Chromium won’t launch because Docker’s shared memory is 64MB. Then Xvfb isn’t configured. Then the UID inside the container doesn’t match your host and everything is permission denied. Then you realize Claude Code’s installer hangs when WORKDIR is root-owned. Then SQLite locks on your NAS mount.

HolyClaude is the container built after solving every single one of those problems. Every bug has been hit, diagnosed, and fixed. Every edge case has been handled. Every “why doesn’t this work in Docker” has been answered.

Image Variants

Latest (Recommended)

The full image with everything pre-installed. Node.js, Python, all seven AI CLIs, deployment tools, PDF libraries, data visualization. Claude never has to stop and install something.

docker pull coderluii/holyclaude

Slim

Core tools only. Claude installs extras on-demand. Smaller download, faster deployment. Same capabilities.

docker pull coderluii/holyclaude:slim

Your Account, Your Keys

HolyClaude runs the real Claude Code CLI from Anthropic. Not a wrapper. Not a proxy. Your existing Anthropic account works directly.

What Works

• Claude Max/Pro plan — Sign in through CloudCLI web UI using the same OAuth flow as desktop Claude Code
• Anthropic API key — Set it in the web UI for pay-per-use billing

What Doesn’t Work

• ChatGPT subscription — That’s a different company and API. OpenAI keys work with Codex CLI (also included)

Other AI CLIs Included

• Gemini CLI (requires Google AI API key)
• OpenAI Codex (requires OpenAI API key)
• Cursor (requires Cursor API key)
• Junie (requires JetBrains account)
• OpenCode (multiple provider support)
• TaskMaster AI (uses existing AI provider keys)

Multi-Platform Support

HolyClaude runs everywhere:

• Linux (amd64) — Native performance, recommended
• Linux (arm64) — Raspberry Pi 4+, Oracle Cloud, AWS Graviton
• macOS (Docker Desktop) — Apple Silicon and Intel
• Windows (WSL2 + Docker Desktop) — Requires WSL2 backend
• Synology/QNAP NAS — Use CHOKIDAR_USEPOLLING=true for SMB mounts

Alternatives Comparison

Support the Project

HolyClaude is free and open source under the MIT license. If this saves you time, consider starring the GitHub repo or supporting the developer:

• Star on GitHub
• GitHub Sponsors
• Buy Me a Coffee

Conclusion

HolyClaude represents months of debugging, configuration, and refinement distilled into a single Docker command. Whether you’re setting up a new development environment, running AI coding agents on a server, or just want to avoid the headache of configuring Chromium in Docker, HolyClaude has you covered.

Your existing Claude subscription works directly. Your credentials stay local. Your code persists on your host. And best of all, you go from zero to AI coding in 30 seconds.

Give it a try. Your future self will thank you.

Get Started View on GitHub