Skip to content

docs(deploy-debian): rewrite to match actual NAS deploy#55

Merged
arniesaha merged 1 commit intomasterfrom
docs/deploy-debian-rewrite
May 4, 2026
Merged

docs(deploy-debian): rewrite to match actual NAS deploy#55
arniesaha merged 1 commit intomasterfrom
docs/deploy-debian-rewrite

Conversation

@arniesaha
Copy link
Copy Markdown
Owner

Summary

  • Rewrite docs/deploy-debian.md so the primary guide matches the actual NAS deploy: user-level systemd at `~/clawd/projects/mux/` with `mux-litellm.service` as a `Requires=` dep.
  • Keep the from-scratch `/opt/mux` + dedicated user variant as an alternative for fresh Debian installs.
  • Add `anthropic-sdk` `MODEL_MAP` caveat (sending OpenAI model names to Anthropic 404s — caught while smoke-testing the PR feat: add /v1/responses passthrough MVP #54 deploy on the NAS).
  • Note the recurring `package-lock.json` peer-flag drift and the troubleshooting row for `404 not_found_error: model: `.
  • Add `loginctl enable-linger` reminder for headless user systemd.

Follow-up to #54.

Test plan

  • Verified the documented upgrade procedure end-to-end on the NAS (PR feat: add /v1/responses passthrough MVP #54 deployed cleanly via `git pull` + `npm ci` + `npm run build` + `systemctl --user restart mux.service`).
  • Verified the `MODEL_MAP` caveat by reproducing the 404 and fixing it (gpt-4o → claude-haiku-4-5-20251001).

🤖 Generated with Claude Code

The original guide assumed system-level systemd at /opt/mux with a
dedicated mux user. Reality on the home NAS is user-level systemd at
~/clawd/projects/mux/ with mux-litellm.service as a Requires= dep.
Document the existing layout (paths, units, upgrade procedure) as the
primary reference, keep the from-scratch /opt/mux variant as an
alternative for fresh installs.

Adds: anthropic-sdk MODEL_MAP caveat (sending OpenAI model names to
Anthropic 404s), package-lock peer-flag drift note, troubleshooting
row for the common 404 not_found_error, loginctl enable-linger note
for headless user systemd.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@arniesaha arniesaha merged commit d9f0389 into master May 4, 2026
1 check passed
@arniesaha arniesaha deleted the docs/deploy-debian-rewrite branch May 4, 2026 06:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant