Repository navigation
Claude on the NAS
Claude Code can live on the NAS beside the hub and show up in the Claude app on
the phone (or claude.ai/code in any browser), so Clippa can be driven, debugged and changed
from anywhere while the laptop sleeps. It runs claude remote-control in a container with its
own clone of the repo. The NAS dials out to Anthropic: no port forwarding, no tailnet, nothing
exposed.
- Run any stage on any stream, read logs and state in the NAS folder, edit
clipper.toml(it backs it up first, as on the laptop). - Change code in its clone (
/app) on a branch, run the tests, push and open a PR.
What it can't: restart or deploy containers (no Docker socket, no ssh). serve, the bot and the
worker keep running the code of the last hub deploy; a merged change reaches them when you run
bash deploy/hub/deploy.sh from the laptop.
It also runs the nightly checkup at CHECKUP_AT (in
env.local; empty = off): clippa checkup, then, only if that finds something, a
claude -p that works out the causes and DMs you one report (read-only, but for one PR for a
clear code fix). After it, on their days, come the
weekly digest and the monthly deep audit.
bash deploy/claude/deploy.sh from the repo root (Git Bash; ssh alias nas). Its own compose
project (clippa-claude; clipper-claude before the rename's pass 3): it never restarts the recorder or the hub, and a hub deploy never
ends a Claude session. Re-running it rebuilds the image (a newer Claude Code at most once a day)
and restarts the container, which ends the session open in the app; the clone and the sign-in
stay.
The first run copies deploy/claude/env.template to deploy/claude/env.local (gitignored) and
stops. Fill in:
- the same keys as
deploy/hub/env.local(ANTHROPIC_API_KEY,KITSU_TOKEN, the Modal token, the alert webhook); the deploy checks them against this machine's own as the hub's does (NAS-hub); -
GH_TOKEN: a GitHub fine-grained token for this repo only, with Contents and Pull requests read and write, so it can push branches and open PRs (and clone the repo, if yours is private); -
CLIPPA_REPO,GIT_USER_NAME,GIT_USER_EMAILcan stay empty: the deploy fills them from the checkout it runs in.
On the NAS, CLAUDE_DIR (/volume1/docker/clipper-claude, which keeps its name for now) holds repo/ (the clone, made on
the first start and left alone after that) and home/ (Claude Code's sign-in, settings and
memory, and the uv cache).
Remote Control needs a claude.ai sign-in (Pro or Max), not an API key, and it refuses to start
where ANTHROPIC_API_KEY is set. So the deploy hands the key to Clippa as a file
(/run/secrets/anthropic_key, [paths] anthropic_key) and keeps it out of the container's
environment. Clippa's model calls still bill the API key as everywhere else; Claude itself
uses the subscription.
Once, after the first deploy. The container waits until it is signed in:
-
ssh -t nas 'cd clippa-claude && docker compose exec claude claude auth login'. Open the link it prints on the laptop or phone, sign in to claude.ai, and paste the code it shows back into the terminal. -
ssh -t nas 'docker attach clippa-claude'. The first start asks to enable Remote Control and to trust/app: answeryto both, then detach with Ctrl-P Ctrl-Q (Ctrl-C would stop it). - In the Claude app on the phone (or claude.ai/code), the session "Clippa on the NAS" is in
the session list. Ask it to run something small, e.g.
clippa doctor --role claude.
The sign-in and both answers are kept in home/, so later deploys and restarts come back by
themselves. A claude.ai sign-in expires: the session warns three days before, then stops
working until step 1 is done again. The container restarts on its own if the NAS is offline for
more than about ten minutes (Remote Control gives up and exits); the app shows a new session.
Each new session starts in CLAUDE_PERMISSION_MODE (default: it asks on the phone before
each command or edit); switch one to Accept edits or Auto in the app. CLAUDE_SESSION_NAME
names it.
Session transcripts are plaintext in home/.claude/projects on the NAS, like on the laptop.
ssh nas 'cd clippa-claude && docker compose exec claude clippa doctor --role claude'It checks what a worker needs (keys, ffmpeg and QSV, Modal, Kitsu) plus Claude Code itself:
installed, signed in, the clone on a branch with nothing left uncommitted, and the streams
writable. Logs: ssh nas 'cd clippa-claude && docker compose logs -f claude'.
If the app can't reach it, ssh nas from the laptop still works, and the war room
is still on the phone through the tailnet (Phone access).
Home · Getting started · clippa doctor · These pages are built from docs/wiki/ in the repo, so edits made here are overwritten: how to edit them
Run it
- Overview
- Getting started
- Roles and services
- Configuration
- Pipeline
- Review
- Reviewing
- War room
- Clippa messenger
- Scheduling and uploads
- Costs
- Checkup
- Audit
- Backups
Install
- Install
- Install checklist
- Kitsu
- Discord app
- YouTube sign-in
- Windows
- macOS
- Transcribe on Modal
- NAS recorder
- NAS hub
- Claude on the NAS
- Phone access
- Model providers
- Adding a show
- YouTube channel
Features
- Pre-shows
- Fetching VODs
- Speakers
- Faces
- Covers
- Cast library
- B-roll
- Clip art
- Weekly issue
- X posts
- TikTok
- News watcher
- Character pieces
- Documentaries
Research
Working on Clippa