Skip to main content

​
Updating

Keep FluffBuzz up to date. The fastest way to update. It detects your install type (npm or git), fetches the latest version, runs fluffbuzz doctor, and restarts the gateway. 
fluffbuzz update
To switch channels or target a specific version: 
fluffbuzz update --channel beta
fluffbuzz update --tag main
fluffbuzz update --dry-run   # preview without applying
See Development channels for channel semantics.

​
Alternative: re-run the installer

curl -fsSL https://fluffbuzz.com/install.sh | bash
Add --no-onboard to skip onboarding. For source installs, pass --install-method git --no-onboard.

​
Alternative: manual npm or pnpm

npm i -g fluffbuzz@latest

pnpm add -g fluffbuzz@latest

​
Auto-updater

The auto-updater is off by default. Enable it in ~/.fluffbuzz/fluffbuzz.json: 
{
  update: {
    channel: "stable",
    auto: {
      enabled: true,
      stableDelayHours: 6,
      stableJitterHours: 12,
      betaCheckIntervalHours: 1,
    },
  },
}
ChannelBehavior
stableWaits stableDelayHours, then applies with deterministic jitter across stableJitterHours (spread rollout).
betaChecks every betaCheckIntervalHours (default: hourly) and applies immediately.
devNo automatic apply. Use fluffbuzz update manually.
The gateway also logs an update hint on startup (disable with update.checkOnStart: false).

​
After updating

1
Run doctor
2
fluffbuzz doctor
3
Migrates config, audits DM policies, and checks gateway health. Details: Doctor
4
Restart the gateway
5
fluffbuzz gateway restart
6
Verify
7
fluffbuzz health

​
Rollback

​
Pin a version (npm)

npm i -g fluffbuzz@<version>
fluffbuzz doctor
fluffbuzz gateway restart
Tip: npm view fluffbuzz version shows the current published version.

​
Pin a commit (source)

git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
pnpm install && pnpm build
fluffbuzz gateway restart
To return to latest: git checkout main && git pull.

​
If you are stuck