Claude Code Unraid Plugin

Installs Claude Code CLI on Unraid.

Fork of brianpugh/unraid-claude-code, fixing a bug where Claude Code's own background self-updates never reached the appdata binary cache (only a fresh install did), so a reboot would silently roll back to the pre-update version and the CLI kept reporting "restart to update" forever. This fork adds a cron job that keeps the cache in sync — and, since Claude Code's updater doesn't reliably swap the active binary either, the cron job now also promotes the newest downloaded build into place itself before caching it.

Install

plugin install https://raw.githubusercontent.com/2CrAzYTV/unraid-claude-code/main/claude-code.plg

Usage

Open the Unraid terminal and run:

claude

Authentication and settings persist across reboots automatically. Configure the appdata path via Settings > Utilities > Claude Code.

Requirements

• Unraid 6.12.0+
• Array started, or appdata on an Unassigned Devices mount
• Internet connection (first install only)

Troubleshooting

Check the install log:

cat /var/log/claude-code-install.log

Manually re-run the installer:

/usr/local/emhttp/plugins/claude-code/scripts/install-claude.sh

Development

# Serve plugin locally
cd /path/to/unraid-claude-code
python3 -m http.server 8080

# On Unraid terminal - install
plugin install http://YOUR_DEV_IP:8080/claude-code.plg

# Reinstall after changes
plugin remove claude-code.plg && plugin install http://YOUR_DEV_IP:8080/claude-code.plg

Releasing

This plugin uses date-based versioning (YYYY.MM.DD) per Unraid plugin conventions.

# Update version to today's date, commit, and tag
bump-my-version replace --new-version 2025.12.01

# Push with tags
git push && git push --tags

The release updates version strings in claude-code.plg automatically via .bumpversion.toml.