Skip to main content
← Back to list
01Issue
FeatureShippedSwamp CLI
Assigneesstack72

Relationships

#451 Docs: document LaunchDaemon autoupdate for root-owned macOS binaries

Opened by stack72 · 5/26/2026· Shipped 5/26/2026

Problem

The how-to guide "Set Up Background Autoupdating" (content/manual/how-to/set-up-background-autoupdating.md) does not cover the LaunchDaemon flow for root-owned binaries, which was added in swamp-club#449 / PR #1451.

Proposed Solution

Add a "Root-owned binaries (macOS)" section after Prerequisites documenting:

  • swamp detects root-owned binaries and installs a LaunchDaemon (system-level) instead of a LaunchAgent (user-level)
  • Setup requires sudo swamp update --setup-auto
  • The plist is installed at /Library/LaunchDaemons/club.swamp.autoupdate.plist
  • Logs go to /var/log/swamp/ instead of ~/Library/Logs/swamp/
  • All management commands (status, disable, config set) require sudo when a LaunchDaemon is installed
  • Clear error messages guide users when sudo is missing

Also update the Troubleshoot section — the "Binary owned by root" bullet currently recommends sudo chown. It should now mention sudo swamp update --setup-auto as the preferred path instead of changing ownership.

Alternatives

File this as a separate PR against swamp-club rather than tracking it as an issue. However, the feature hasn't shipped yet so an issue is appropriate until the PR merges.

02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED+ 1 MOREASSIGNED+ 4 MOREREVIEW+ 3 MOREPR_MERGED+ 1 MORENOTIFICATION_SKIPPED

Shipped

5/26/2026, 7:43:45 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack725/26/2026, 7:26:20 PM

Sign in to post a ripple.