FlareDeskDocs

Troubleshooting

Common issues and solutions

Having trouble with FlareDesk? Check these common issues and their solutions.

Wrangler Not Found

Problem: FlareDesk can't find the Wrangler CLI.

Install Wrangler globally: npm install -g wrangler

Verify installation: wrangler --version

Restart FlareDesk after installing

Port Already in Use

Problem: The dev server can't start because port 8787 is occupied.

Click "Kill Process" when FlareDesk prompts you

Or change the port in Project Settings

Manually find and kill: lsof -i :8787 then kill -9 PID

Bindings Not Detected

Problem: FlareDesk doesn't show your bindings.

Ensure your wrangler.toml is properly formatted

Try removing and re-adding the project

Check that binding configurations follow Cloudflare's syntax

Dev Server Won't Start

Problem: The Wrangler dev server fails to start.

Check console logs for error messages

Ensure all dependencies are installed: npm install

Verify your wrangler.toml is valid

Try starting Wrangler manually: wrangler dev

License Activation Fails

Problem: Can't activate your license key.

Ensure you have an internet connection

Verify the license key is correct (no extra spaces)

Check if the license is already activated on another device

Contact support if the issue persists

Tunnel Fails to Start

Problem: The tunnel feature doesn't work.

Install cloudflared: brew install cloudflared

Verify installation: cloudflared --version

Ensure your dev server is running first

Check firewall settings

App Won't Open (macOS Security)

Problem: macOS blocks FlareDesk from opening.

Right-click (or Control-click) FlareDesk in Applications

Select "Open" from the context menu

Click "Open" in the dialog that appears

You only need to do this once

Profiler Not Working

Problem: The profiler shows no data.

Ensure the profiler is enabled in Project Settings

Restart the dev server after enabling (required!)

Make requests that use bindings

Getting Help

Still having issues? Reach out for support:

When reporting issues, include:
  • FlareDesk version (from Settings)
  • macOS version
  • Wrangler version
  • Steps to reproduce the issue
  • Any error messages