Claude Code

Claude Code is a self-hosted Docker container that keeps an always-on Claude Code session on your homelab, so the agent stays reachable from a phone or tablet…

  • AI
  • Development
  • Productivity
  • Tools & Utilities
Claude Code is a self-hosted Docker container that keeps an always-on Claude Code session on your homelab, so the agent stays reachable from a phone or tablet even when your laptop is closed or off the network. A persistent tmux server holds the live session and host networking lets the container reach the LAN directly; the image bundles ssh, sshpass, gh, ripgrep, jq and common network-inspection tools. You can reattach the same session from any device over SSH or use it from the Claude mobile app through remote control. Aimed at homelabbers who want round-the-clock agentic terminal access to their server.

Platform availability

Available on 2 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

51/100 Fair

Maintained
65last commit 104 days ago
Popular
2415 GitHub stars
Easy to install
452 install platforms, install notes, Docker image
Light to run
304 GB minimum RAM
Security check
79no serious findings, 1 minor, CI

Availability: platform listings confirmed today, links checked 24 days ago

GitHub stars
15
Open issues
1
Last commit
2026-08-09
Activity
stale

Checked 13 days ago - source: GitHub (anthropics-claude/claude-code)

Resources & Compatibility

Minimum requirements: 4 GB RAM. ARM (e.g. Raspberry Pi) is not supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Run a quick install check before using it After installing, run `claude doctor` from your terminal. It checks installation health and settings without starting a session, then flags errors and suggests fixes so you catch setup problems before they annoy you. source
  • Fix install folder ownership if setup fails On macOS/Linux, if you see permission errors, run the documented `sudo` commands to create `~/.local/bin` and make `~/.local` owned by your user. This fixes common “permission denied” problems that can stop Claude Code from starting. source
  • Use guided self-hosted runner setup If you are connecting your own machines as self-hosted runners, run `claude self-hosted-runner setup` after logging in with the Owner account (the account allowed to manage the setup). It walks through environment creation, secret registration, and verification, so you don’t miss required steps that block the runner. source
  • First run: sign in and attach On first run, sign in inside the container with the claude-login command; do not copy the OAuth URL out of a wrapped terminal by hand. To join the live session from another device, SSH into the host and run tmux attach -t main, or use docker exec -it claude-code tmux attach -t main. source

Fetched 39 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How do I verify a Claude Code installation before starting a session?

Run claude doctor from your terminal. It checks installation health and settings without starting a session and suggests fixes.

How can I fix Claude Code permission errors on macOS or Linux?

Use the documented sudo commands to create ~/.local/bin and make ~/.local owned by your user. This resolves common permission denied errors that can stop Claude Code from starting.

Where should I look for common Claude Code errors and their fixes?

A practical reference lists common errors with the cause and fix command for each. It starts with the claude doctor, /status, and /context diagnostics.

Do all Claude Code usage surfaces require a paid Anthropic account?

Most surfaces require a Claude subscription or Anthropic Console account. The terminal CLI, VS Code, and JetBrains also support third-party providers.

Answers sourced from arte.itlibra.com, code.claude.com, code.claude.com, code.claude.com

Community

Collected 53 days ago - public community threads