FluffDock

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

Command	Description
`fluffdock-start`	Start the gateway
`fluffdock-stop`	Stop the gateway
`fluffdock-restart`	Restart the gateway
`fluffdock-status`	Check container status
`fluffdock-logs`	Follow gateway logs

Container access

Command	Description
`fluffdock-shell`	Open 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

Command	Description
`fluffdock-dashboard`	Open the Control UI URL
`fluffdock-devices`	List pending device pairings
`fluffdock-approve <id>`	Approve a pairing request

Setup and maintenance

Command	Description
`fluffdock-fix-token`	Configure the gateway token inside the container
`fluffdock-update`	Pull, rebuild, and restart
`fluffdock-rebuild`	Rebuild the Docker image only
`fluffdock-clean`	Remove containers and volumes

Utilities

Command	Description
`fluffdock-health`	Run a gateway health check
`fluffdock-token`	Print the gateway token
`fluffdock-cd`	Jump to the FluffBuzz project directory
`fluffdock-config`	Open `~/.fluffbuzz`
`fluffdock-show-config`	Print config files with redacted values
`fluffdock-workspace`	Open 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.

Install overview

Containers

Hosting

Maintenance

Install

What you get

Basic operations

Container access

Web UI and pairing

Setup and maintenance

Utilities

First-time flow

Config and secrets

​Install

​What you get

​Basic operations

​Container access

​Web UI and pairing

​Setup and maintenance

​Utilities

​First-time flow

​Config and secrets

​Related pages

Install

What you get

Basic operations

Container access

Web UI and pairing

Setup and maintenance

Utilities

First-time flow

Config and secrets

Related pages