pmb/yttrx-welcomebot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Document /root/bin as the real install location (symlinked from /usr/local/bin)

Browse Source
This commit is contained in:
Pete
2026-07-02 16:57:03 -07:00
parent 0fd6f1c142
commit 6ad9a93f38
1 changed files with 15 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CLAUDE.md
+15 -8
View File
@@ -91,9 +91,14 @@ ssh admin.yttrx.com 'docker exec yttrx-welcomebot python -c \
### Viewing logs
A `welcomebot-logs` CLI is installed at `/usr/local/bin/welcomebot-logs` on
admin.yttrx.com (source: `bin/welcomebot-logs` in this repo). It wraps
`docker logs` for the container:
A `welcomebot-logs` CLI lives at `/root/bin/welcomebot-logs` on admin.yttrx.com
(source: `bin/welcomebot-logs` in this repo) — `/root/bin` is the homelab's
standard location for root-owned admin scripts (same convention as `bsd`'s
`peteftw-analytics` and the NAS backup scripts). A symlink at
`/usr/local/bin/welcomebot-logs` makes the bare command work over
non-interactive `ssh admin.yttrx.com welcomebot-logs`, since that doesn't
source `~/.bashrc` and so wouldn't otherwise see `/root/bin` on `PATH`. It
wraps `docker logs` for the container:
```bash
ssh admin.yttrx.com welcomebot-logs # last 200 lines
@@ -105,10 +110,10 @@ ssh admin.yttrx.com 'welcomebot-logs --help'
### Inspecting signup-IP classification history
`welcomebot-signups` (also `/usr/local/bin/welcomebot-signups`, source
`bin/welcomebot-signups`) reads the persistent `signup_ip` sqlite table
directly — a permanent record of every classification decision, independent
of log retention:
`welcomebot-signups` (`/root/bin/welcomebot-signups`, symlinked from
`/usr/local/bin` same as above; source `bin/welcomebot-signups`) reads the
persistent `signup_ip` sqlite table directly — a permanent record of every
classification decision, independent of log retention:
```bash
ssh admin.yttrx.com welcomebot-signups # last 20 decisions
@@ -122,7 +127,9 @@ reinstall with:
```bash
ssh admin.yttrx.com 'cd /root/yttrx-welcomebot && git pull origin main && \
install -m755 bin/welcomebot-logs bin/welcomebot-signups /usr/local/bin/'
install -m755 bin/welcomebot-logs bin/welcomebot-signups /root/bin/'
# /usr/local/bin/welcomebot-{logs,signups} are symlinks to /root/bin — no
# need to touch them again once created.
```
### Rollback