Skip to main content
FluffDock is a small shell-helper layer for Docker-based FluffBuzz installs. It gives you short commands like fluffdock-start, fluffdock-dashboard, and fluffdock-fix-token instead of longer docker compose ... invocations. If you have not set up Docker yet, start with Docker.

​
Install

Use the canonical helper path: 
mkdir -p ~/.fluffdock && curl -sL https://raw.githubusercontent.com/fluffbuzz/fluffbuzz/main/scripts/fluffdock/fluffdock-helpers.sh -o ~/.fluffdock/fluffdock-helpers.sh
echo 'source ~/.fluffdock/fluffdock-helpers.sh' >> ~/.zshrc && source ~/.zshrc
If you previously installed FluffDock from scripts/shell-helpers/fluffdock-helpers.sh, reinstall from the new scripts/fluffdock/fluffdock-helpers.sh path. The old raw GitHub path was removed.

​
What you get

​
Basic operations

CommandDescription
fluffdock-startStart the gateway
fluffdock-stopStop the gateway
fluffdock-restartRestart the gateway
fluffdock-statusCheck container status
fluffdock-logsFollow gateway logs

​
Container access

CommandDescription
fluffdock-shellOpen a shell inside the gateway container
fluffdock-cli <command>Run FluffBuzz CLI commands in Docker
fluffdock-exec <command>Execute an arbitrary command in the container

​
Web UI and pairing

CommandDescription
fluffdock-dashboardOpen the Control UI URL
fluffdock-devicesList pending device pairings
fluffdock-approve <id>Approve a pairing request

​
Setup and maintenance

CommandDescription
fluffdock-fix-tokenConfigure the gateway token inside the container
fluffdock-updatePull, rebuild, and restart
fluffdock-rebuildRebuild the Docker image only
fluffdock-cleanRemove containers and volumes

​
Utilities

CommandDescription
fluffdock-healthRun a gateway health check
fluffdock-tokenPrint the gateway token
fluffdock-cdJump to the FluffBuzz project directory
fluffdock-configOpen ~/.fluffbuzz
fluffdock-show-configPrint config files with redacted values
fluffdock-workspaceOpen the workspace directory

​
First-time flow

fluffdock-start
fluffdock-fix-token
fluffdock-dashboard
If the browser says pairing is required: 
fluffdock-devices
fluffdock-approve <request-id>

​
Config and secrets

FluffDock works with the same Docker config split described in Docker:
  • <project>/.env for Docker-specific values like image name, ports, and the gateway token
  • ~/.fluffbuzz/.env for env-backed provider keys and bot tokens
  • ~/.fluffbuzz/agents/<agentId>/agent/auth-profiles.json for stored provider OAuth/API-key auth
  • ~/.fluffbuzz/fluffbuzz.json for behavior config
Use fluffdock-show-config when you want to inspect the .env files and fluffbuzz.json quickly. It redacts .env values in its printed output.