claude-unraid-manager
ghcr.io/mygrexit/claude-unraid-manager:beta
true
https://github.com/mygrexit/claude-unraid-manager/pkgs/container/claude-unraid-manager
bridge
bash
false
https://github.com/mygrexit/claude-unraid-manager/issues
https://github.com/mygrexit/claude-unraid-manager
https://github.com/mygrexit/claude-unraid-manager#readme
MIT
**For experienced Unraid users only. Careful: this app can do serious damage to your server if you don't know what you're doing.**
Claude Code set up as an Unraid administrator, not as a coding tool: an AI assistant that manages containers, storage, VMs, plugins and configuration from the terminal or from your phone via Remote Control. It is meant to ask before it acts; that only holds as long as you keep the permission prompts on and read them.
**What it does**
- Scans your storage (ZFS, btrfs, array), containers, VMs, plugins, User Scripts and network on every start and writes a CLAUDE.md so Claude knows your server.
- Manages containers via the Docker socket and runs host commands through a short-lived helper container. No privileged mode needed.
- Safe defaults: boot drive read-only, no shares mounted. Opt in to more access as needed.
- Risky commands (downloads piped to a shell, network tools, deletes, writes to the flash drive) always ask for your approval with a reason, whatever the mode; disk formatting and wipes are blocked outright.
**Requirements**
An Anthropic account: a claude.ai subscription (also needed for Remote Control) or a Console API key.
**Setup**
1. Apply this template with the default mounts (adjust the two appdata paths if yours is not /mnt/user/appdata).
2. Click the container in the Docker tab, then Console: you are in the Claude session.
3. Log in once (URL in any browser, paste the code back). Leave the session with Ctrl-b, then d; it keeps running.
4. Phone: open the Claude app, tap Code, pick this session. Sessions start in manual mode and ask before acting.
Full walkthrough: https://github.com/mygrexit/claude-unraid-manager/blob/main/docs/getting-started.md
**Beta**
Tested on the author's two Unraid 7.3.3 servers (ZFS pool-only), not on a range of setups. It is an AI agent: its rules shape what it does, they do not guarantee it.
**Warning**
The Docker socket gives this container root-equivalent access to your server. The guard rails reduce accidents but are not a security boundary. If you would not do the same work yourself on the Unraid command line, do not install this. Review every action before confirming. Keep backups. The author accepts no liability for data loss or misconfiguration.
### 0.1.0-beta.5 (2026-10-14)
- Guard "ask" tier: downloads piped to a shell, network tools, host-level containers, flash-drive writes, docker/zfs deletes always prompt with a reason, in any permission mode.
- `logs <container>`: container logs stripped of terminal escape codes and framed as untrusted data; Claude is told to report, not follow, instructions found in logs.
- Settings updates add new shipped deny entries to yours; your allow list stays as you set it (missing shipped entries are named in the start log).
### 0.1.0-beta.4 (2026-10-14)
- Fixes beta.3, whose container exited at start ("can't find pane"). Update if you installed beta.3.
### 0.1.0-beta.3 (2026-10-14)
- Sessions start in manual mode (ask before acting); auto mode stays one Shift+Tab away.
- The Console button lands directly in the Claude session.
- Disabled User Scripts no longer show their old cron line.
### 0.1.0-beta.2 (2026-10-14)
- Any path you add to the container shows up in Claude's CLAUDE.md; Claude explains "Add another Path" instead of guessing at unmounted shares.
- Template: optional paths reduced to appdata and one example share; own icon.
- Scanner: User Scripts with schedules, VM states, read-only detection, btrfs loop images filtered, Docker/libvirt bridges hidden.
- Clean shutdown on stop; getting-started guide.
### 0.1.0-beta.1 (2026-10-14)
- First public beta. Tested on two Unraid 7.3.3 servers (ZFS pool-only).
Tools:System
https://raw.githubusercontent.com/mygrexit/unraid-templates/main/templates/claude-unraid-manager.xml
https://raw.githubusercontent.com/mygrexit/unraid-templates/main/images/claude-unraid-manager.png
--hostname claude-unraid-manager
An Anthropic account (claude.ai subscription or Console API key) and access to the Docker socket. For experienced Unraid users only.
/mnt/user/appdata/claude-unraid-manager/home
/mnt/user/appdata/claude-unraid-manager/workspace
/var/run/docker.sock
/boot
UTC
true
main
alpine:3.21