Support Centre

Get help with Triggerfish installation, configuration, and day-to-day operations.

Quick Links

• Something broken right now? Start with the Troubleshooting Guide
• Need to look up an error? See the Error Reference
• Want to file a bug? Read How to File a Good Issue first
• Upgrading or migrating? Check the Knowledge Base

Self-Service Resources

Troubleshooting

Step-by-step guides for diagnosing and fixing common problems, organised by area:

Area	Covers
Installation	Install failures, permission errors, platform-specific setup
Daemon	Start/stop issues, service management, port conflicts
Configuration	YAML parsing, validation errors, secret references
Channels	Telegram, Slack, Discord, WhatsApp, Signal, Email, WebChat
LLM Providers	API key errors, model not found, streaming failures, failover
Integrations	Google, GitHub, Notion, CalDAV, MCP servers
Browser Automation	Chrome detection, launch failures, Flatpak, navigation
Security & Classification	Taint escalation, write-down blocks, SSRF, policy denials
Secrets & Credentials	Keychain backends, permission errors, encrypted file store
Error Reference	Searchable index of every error message

How-To Guides

Guide	Description
Collecting Logs	How to gather log bundles for bug reports
Running Diagnostics	Using triggerfish patrol and the healthcheck tool
Filing Issues	What to include so your issue gets resolved quickly
Platform Notes	macOS, Linux, Windows, Docker, and Flatpak specifics

Knowledge Base

Article	Description
Secrets Migration	Migrating from plaintext to encrypted secret storage
Self-Update Process	How triggerfish update works and what can go wrong
Breaking Changes	Version-by-version list of breaking changes
Known Issues	Current known issues and their workarounds

Still Stuck?

If the docs above did not solve your problem:

1. Search existing issues on GitHub Issues to see if someone already reported it
2. Ask the community in GitHub Discussions
3. File a new issue following the issue filing guide