Browser troubleshooting

Problem: “Failed to start Chrome CDP on port 18800”

FluffBuzz’s browser control server fails to launch Chrome/Brave/Edge/Chromium with the error:

{"error":"Error: Failed to start Chrome CDP on port 18800 for profile \"fluffbuzz\"."}

Root Cause

On Ubuntu (and many Linux distros), the default Chromium installation is a snap package. Snap’s AppArmor confinement interferes with how FluffBuzz spawns and monitors the browser process. The apt install chromium command installs a stub package that redirects to snap:

Note, selecting 'chromium-browser' instead of 'chromium'
chromium-browser is already the newest version (2:1snap1-0ubuntu2).

This is NOT a real browser - it’s just a wrapper.

Solution 1: Install Google Chrome (Recommended)

Install the official Google Chrome .deb package, which is not sandboxed by snap:

wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb
sudo apt --fix-broken install -y  # if there are dependency errors

Then update your FluffBuzz config (~/.fluffbuzz/fluffbuzz.json):

{
  "browser": {
    "enabled": true,
    "executablePath": "/usr/bin/google-chrome-stable",
    "headless": true,
    "noSandbox": true
  }
}

Solution 2: Use Snap Chromium with Attach-Only Mode

If you must use snap Chromium, configure FluffBuzz to attach to a manually-started browser:

Update config:

{
  "browser": {
    "enabled": true,
    "attachOnly": true,
    "headless": true,
    "noSandbox": true
  }
}

Start Chromium manually:

chromium-browser --headless --no-sandbox --disable-gpu \
  --remote-debugging-port=18800 \
  --user-data-dir=$HOME/.fluffbuzz/browser/fluffbuzz/user-data \
  about:blank &

Optionally create a systemd user service to auto-start Chrome:

# ~/.config/systemd/user/fluffbuzz-browser.service
[Unit]
Description=FluffBuzz Browser (Chrome CDP)
After=network.target

[Service]
ExecStart=/snap/bin/chromium --headless --no-sandbox --disable-gpu --remote-debugging-port=18800 --user-data-dir=%h/.fluffbuzz/browser/fluffbuzz/user-data about:blank
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target

Enable with: systemctl --user enable --now fluffbuzz-browser.service

Verifying the Browser Works

Check status:

curl -s http://127.0.0.1:18791/ | jq '{running, pid, chosenBrowser}'

Test browsing:

curl -s -X POST http://127.0.0.1:18791/start
curl -s http://127.0.0.1:18791/tabs

Config Reference

Option	Description	Default
`browser.enabled`	Enable browser control	`true`
`browser.executablePath`	Path to a Chromium-based browser binary (Chrome/Brave/Edge/Chromium)	auto-detected (prefers default browser when Chromium-based)
`browser.headless`	Run without GUI	`false`
`browser.noSandbox`	Add `--no-sandbox` flag (needed for some Linux setups)	`false`
`browser.attachOnly`	Don’t launch browser, only attach to existing	`false`
`browser.cdpPort`	Chrome DevTools Protocol port	`18800`

Problem: “No Chrome tabs found for profile=“user""

You’re using an existing-session / Chrome MCP profile. FluffBuzz can see local Chrome, but there are no open tabs available to attach to. Fix options:

Use the managed browser: fluffbuzz browser start --browser-profile fluffbuzz (or set browser.defaultProfile: "fluffbuzz").
Use Chrome MCP: make sure local Chrome is running with at least one open tab, then retry with --browser-profile user.

Notes:

user is host-only. For Linux servers, containers, or remote hosts, prefer CDP profiles.
user / other existing-session profiles keep the current Chrome MCP limits: ref-driven actions, one-file upload hooks, no dialog timeout overrides, no wait --load networkidle, and no responsebody, PDF export, download interception, or batch actions.
Local fluffbuzz profiles auto-assign cdpPort/cdpUrl; only set those for remote CDP.
Remote CDP profiles accept http://, https://, ws://, and wss://. Use HTTP(S) for /json/version discovery, or WS(S) when your browser service gives you a direct DevTools socket URL.

Overview

Plugins

Skills

Automation & Tasks

Tools

Agent coordination

Browser troubleshooting

Problem: “Failed to start Chrome CDP on port 18800”

Root Cause

Solution 1: Install Google Chrome (Recommended)

Solution 2: Use Snap Chromium with Attach-Only Mode

Verifying the Browser Works

Config Reference

Problem: “No Chrome tabs found for profile=“user""

​Problem: “Failed to start Chrome CDP on port 18800”

​Root Cause

​Solution 1: Install Google Chrome (Recommended)

​Solution 2: Use Snap Chromium with Attach-Only Mode

​Verifying the Browser Works

​Config Reference

​Problem: “No Chrome tabs found for profile=“user""

​Related

Problem: “Failed to start Chrome CDP on port 18800”

Root Cause

Solution 1: Install Google Chrome (Recommended)

Solution 2: Use Snap Chromium with Attach-Only Mode

Verifying the Browser Works

Config Reference

Problem: “No Chrome tabs found for profile=“user""

Related