Cloudflare Migration — TILSIT Deployment Checklist¶
History. Done. This is the deployment checklist for the 2026-02-23 Cloudflare DNS-01 plan, and every task below is marked done. #106 (2026-04-03) imported it from the tilsit-caddy repository as a completed migration. Tasks 9 and 10 changed the host-level PIA Desktop and split-tunnel stack. That stack was retired after Transmission moved into the haugene/transmission-openvpn container (#78, 2026-03-10), and those tasks were marked obsolete on 2026-04-15 (#121). Do not follow them. DDNS is now a separate daemon, not part of plex-vpn-bypass.sh. For the current setup see Caddy, Cloudflare DDNS and TLS strategy.
Commands run in your SSH session on TILSIT unless marked Dev machine.
✅ Task 1: Store CF_API_TOKEN in System keychain — DONE¶
Dev machine — retrieve token and store it on TILSIT in one step:
# Dev machine
CF_TOKEN=$(op read "op://<vault>/<item>/API/zone DNS API token")
ssh operator@your-server.local "sudo security add-generic-password \
-U \
-s 'cloudflare-api-token' \
-a 'tilsit.vip' \
-w '${CF_TOKEN}' \
/Library/Keychains/System.keychain"
unset CF_TOKEN
Verify on TILSIT:
sudo security find-generic-password \
-s "cloudflare-api-token" \
-a "tilsit.vip" \
-w \
/Library/Keychains/System.keychain
Expected: token string printed, no error.
✅ Task 2: Install pre-built Caddy with Cloudflare module — DONE¶
Dev machine — download the official Caddy binary with the Cloudflare DNS plugin:
# Dev machine
curl -L "https://caddyserver.com/api/download?os=darwin&arch=arm64&p=github.com%2Fcaddy-dns%2Fcloudflare" \
-o /tmp/caddy-cloudflare
chmod +x /tmp/caddy-cloudflare
/tmp/caddy-cloudflare list-modules | grep cloudflare
rsync /tmp/caddy-cloudflare operator@your-server.local:/tmp/caddy-cloudflare
As operator:
sudo cp /opt/homebrew/bin/caddy /opt/homebrew/bin/caddy.homebrew-backup
sudo cp /tmp/caddy-cloudflare /opt/homebrew/bin/caddy
sudo chmod +x /opt/homebrew/bin/caddy
/opt/homebrew/bin/caddy version
/opt/homebrew/bin/caddy list-modules | grep cloudflare
As admin:
Expected: dns.providers.cloudflare listed, caddy shown as pinned.
✅ Task 6: Deploy Caddy changes to TILSIT — DONE¶
✅ Step 1 — deploy caddy-wrapper.sh¶
# Dev machine
rsync /Users/admin/Developer/tilsit/tilsit-caddy-v1/caddy-wrapper.sh \
operator@your-server.local:/tmp/caddy-wrapper.sh
sudo cp /tmp/caddy-wrapper.sh /usr/local/bin/caddy-wrapper.sh
sudo chmod 755 /usr/local/bin/caddy-wrapper.sh
sudo chown root:wheel /usr/local/bin/caddy-wrapper.sh
✅ Step 2 — smoke test the wrapper¶
Expected: Caddy help text (not a keychain error).
✅ Step 3 — back up Caddyfile¶
✅ Step 4 — validate on TILSIT¶
✅ Step 5 — move validated Caddyfile into place¶
✅ Step 6 — deploy updated LaunchDaemon plist¶
# Dev machine
rsync /Users/admin/Developer/tilsit/tilsit-caddy-v1/LaunchDaemons/com.caddyserver.caddy.plist \
operator@your-server.local:/tmp/com.caddyserver.caddy.plist
sudo cp /tmp/com.caddyserver.caddy.plist \
/Library/LaunchDaemons/com.caddyserver.caddy.plist
sudo chown root:wheel /Library/LaunchDaemons/com.caddyserver.caddy.plist
sudo chmod 644 /Library/LaunchDaemons/com.caddyserver.caddy.plist
✅ Task 7: Clear stale ACME state + verify cert issuance — DONE¶
Three rounds of failures, all now fixed and documented in CLAUDE.md:
- Staging ACME account reused → fixed: explicit
dir https://acme-v02...in Caddyfile certmagicTCP/53 timeout querying Cloudflare auth NS → fixed:propagation_timeout -1(PIA VPN blocks direct NS queries; LE does its own check){env.CF_API_TOKEN}not substituted at parse time → fixed:{$CF_API_TOKEN}(Caddyfile parse-time syntax)- Propagation race: LE checked before Cloudflare NS served the record → fixed:
propagation_delay 30s
Cert obtained successfully 2026-02-23. ssl_verify_result=0 confirmed.
✅ Step 1 — remove stale certs — DONE¶
✅ Step 2 — reload LaunchDaemon — DONE¶
✅ Step 3 — deploy fixed Caddyfile — DONE¶
# Dev machine
rsync /Users/admin/Developer/tilsit/tilsit-caddy-v1/Caddyfile \
operator@your-server.local:/tmp/Caddyfile.new
Validate on TILSIT:
sudo CF_API_TOKEN=$(security find-generic-password \
-s cloudflare-api-token -a tilsit.vip -w \
/Library/Keychains/System.keychain) \
HOSTNAME=tilsit \
/opt/homebrew/bin/caddy validate \
--config /tmp/Caddyfile.new \
--adapter caddyfile
Expected: Valid configuration
Copy into place:
✅ Step 4 — clear ALL stale ACME state — DONE¶
✅ Step 5 — reload LaunchDaemon — DONE¶
✅ Step 6 — watch for cert issuance — DONE¶
✅ Step 7 — verify cert — DONE (ssl_verify_result=0)¶
Reference: what was cleared and why¶
The following steps are retained for future reference if cert state needs to be reset again.
Both staging and production account/cert state must go, or Caddy may reuse the broken staging account:
rm -rf "/Users/operator/Library/Application Support/Caddy/certificates/acme-staging-v02.api.letsencrypt.org-directory"
rm -rf "/Users/operator/Library/Application Support/Caddy/certificates/acme-v02.api.letsencrypt.org-directory"
rm -rf "/Users/operator/Library/Application Support/Caddy/acme/acme-staging-v02.api.letsencrypt.org-directory"
rm -rf "/Users/operator/Library/Application Support/Caddy/acme/acme-v02.api.letsencrypt.org-directory"
ls "/Users/operator/Library/Application Support/Caddy/certificates/"
ls "/Users/operator/Library/Application Support/Caddy/acme/"
Expected: only local/ remains under certificates/; acme/ directory empty or absent.
Step 5 — reload LaunchDaemon¶
sudo launchctl unload /Library/LaunchDaemons/com.caddyserver.caddy.plist
sudo launchctl load /Library/LaunchDaemons/com.caddyserver.caddy.plist
Step 6 — watch for cert issuance¶
tail -f ~/.local/state/caddy/caddy-error.log | grep -i 'tilsit\|acme\|certif\|cloudflare\|obtain\|error'
Expected within ~60 seconds (Let's Encrypt does its own propagation check from their servers):
"msg":"obtaining certificate","identifier":"tilsit.vip"
"msg":"certificate obtained successfully","identifier":"tilsit.vip"
If you see a dns.providers.cloudflare error or forbidden, check:
- Token has
Zone:DNS:Editpermission for thetilsit.vipzone dig NS tilsit.vipreturns Cloudflare nameservers
Step 7 — verify cert¶
Expected: 200 0 or 401 0 — ssl_verify_result=0 means valid trusted cert.
✅ Task 9: Patch live plex-vpn-bypass.sh + verify DDNS — DONE¶
Step 1 — prepare patched script¶
# Dev machine
cp /Users/admin/Developer/mac-server-setup/app-setup/templates/plex-vpn-bypass.sh \
/tmp/plex-vpn-bypass-new.sh
# Ids from local/operator-notes.md; stop if either is unset.
: "${CLOUDFLARE_ZONE_ID:?set it from the operator note}"
: "${CLOUDFLARE_RECORD_ID:?set it from the operator note}"
sed -i '' 's|__SERVER_NAME__|TILSIT|g' /tmp/plex-vpn-bypass-new.sh
sed -i '' 's|__OPERATOR_USERNAME__|operator|g' /tmp/plex-vpn-bypass-new.sh
sed -i '' 's|__EXTERNAL_HOSTNAME__|tilsit.vip|g' /tmp/plex-vpn-bypass-new.sh
sed -i '' "s|__CLOUDFLARE_ZONE_ID__|${CLOUDFLARE_ZONE_ID}|g" /tmp/plex-vpn-bypass-new.sh
sed -i '' "s|__CLOUDFLARE_RECORD_ID__|${CLOUDFLARE_RECORD_ID}|g" /tmp/plex-vpn-bypass-new.sh
grep '__[A-Z]' /tmp/plex-vpn-bypass-new.sh \
&& echo "ERROR: unsubstituted placeholders" \
|| echo "All substituted"
rsync /tmp/plex-vpn-bypass-new.sh operator@your-server.local:/tmp/plex-vpn-bypass-new.sh
Step 2 — deploy¶
sudo cp /tmp/plex-vpn-bypass-new.sh /usr/local/bin/plex-vpn-bypass.sh
sudo chmod 755 /usr/local/bin/plex-vpn-bypass.sh
sudo chown root:wheel /usr/local/bin/plex-vpn-bypass.sh
Step 3 — restart daemon¶
Step 4 — verify DDNS in log¶
Expected:
Cloudflare DNS updated: tilsit.vip -> 203.0.113.10
Updating Plex customConnections to https://tilsit.vip:32400
Plex customConnections updated successfully
Step 5 — verify A record¶
Run from dev machine — PIA blocks UDP/53 to external resolvers from TILSIT:
Expected: 203.0.113.10
✅ Task 10: Remove NoIP DUC — DONE¶
Step 1 — remove from PIA split tunnel (GUI on TILSIT)¶
PIA → Settings → Split Tunnel → remove /Applications/No-IP DUC.app from Bypass VPN list → Save
Step 2 — quit and uninstall¶
Then drag /Applications/No-IP DUC.app to Trash, empty Trash.
Step 3 — verify PIA reference config is clean¶
jq -r '[.. | strings | select(test("noip";"i"))] | if length == 0 then "NoIP not in reference" else .[] end' ~/.local/etc/pia-split-tunnel-reference.json
If NoIP still appears, save a new reference: