Repository navigation
Phone access
The war room listens on localhost only. To open it from the phone anywhere, put it on your
tailnet with tailscale serve: HTTPS at the machine's tailnet name, reachable only by your
own Tailscale devices, nothing on the LAN or the internet, no port forwarding.
- Install Tailscale on the machine that runs
clippa serve(https://tailscale.com/download) and on the phone (App Store / Play Store), and sign in to the same account on both. - In the Tailscale admin console, DNS page: turn on MagicDNS and HTTPS certificates
(
tailscale serveasks for this the first time if it is off). The firstonmay also print a link to enable Serve for the tailnet: open it, allow, and the command carries on. -
clippa warroom --tailnet on. It makes a war room token insecrets/warroom_token.txtif[warroom] tokenis empty, startstailscale serve(it persists across reboots), and prints the link to open once on the phone (https://<name>.ts.net/?key=...). The key is printed only there; the phone keeps a cookie for a year. - Restart serve (
clippa services restart serve) so the war room asks for the token, and set[warroom] tailnet = truein clipper.toml. - On the phone, open the link, then Share / menu → Add to Home Screen.
Check: clippa doctor --role serve (fetches the war room through the tailnet name), or
clippa warroom --tailnet status. Off again: clippa warroom --tailnet off.
With serve on the NAS (NAS hub), the tailscale container is the tailnet machine
(clipper.<tailnet>.ts.net, TS_HOSTNAME in deploy/hub/env.local). It needs signing in
once; the login lives in the tailscale-state volume after that. The easy way is an auth key
in TS_AUTHKEY before deploying. Without one, the container's own sign-in link is no use: its
startup gives up after about a minute and restarts with a new link. Sign in from a one-off
daemon on the same volumes instead, then start the service:
ssh nas 'cd clippa-hub && docker compose stop tailscale && docker run -d --name ts-login --network host -v clipper-hub_tailscale-state:/var/lib/tailscale -v clippa-hub_tailscale-socket:/var/run/tailscale --entrypoint tailscaled tailscale/tailscale:v1.104.4 --tun=userspace-networking --statedir=/var/lib/tailscale --socket=/var/run/tailscale/tailscaled.sock'ssh nas 'docker exec ts-login tailscale --socket=/var/run/tailscale/tailscaled.sock up --hostname=clipper --timeout=0'Open the link it prints and approve. If it still says logged out afterwards, restart ts-login
and run up again (the first approval here didn't reach it). Then:
ssh nas 'docker rm -f ts-login && cd clippa-hub && docker compose up -d tailscale && docker compose restart serve'Restart serve so its health and the bot's links show the tailnet address. The container serves the war room itself
from deploy/hub/tailscale-serve.json, so clippa warroom --tailnet on isn't used there (the
Clippa containers aren't root and can't change Tailscale's settings; --tailnet status works).
Open https://clipper.<tailnet>.ts.net/?key=<token> once on the phone, with the token from
secrets/warroom_token.txt in the NAS folder. Turn the laptop's off (clippa warroom --tailnet off there).
Tailscale expires a machine's node key after 180 days by default. When it does, the machine drops
off the tailnet and the war room stops answering on the phone until you sign in again. The
clippa machine is meant to run unattended, so turn expiry off for it once:
- Open the admin console's Machines page (https://login.tailscale.com/admin/machines).
- Find
clippa(the NAS container; the laptop and phone are separate rows), click its...menu at the right of the row, and choose Disable key expiry. - Check the row: it now shows an Expiry disabled badge under the machine's name.
Do this once after the first sign-in; it survives restarts and updates, and sticks to the machine
for as long as it stays registered. If you ever remove the machine and sign in again (a lost
tailscale-state volume, say), it is a new machine and the setting needs doing again.
An auth key (TS_AUTHKEY) has its own expiry, but that only matters for the first sign-in: once
the machine has logged in, the key is no longer used. Disabling key expiry on the machine is the
step that keeps it signed in.
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