Skip to main content

Help and Support

The more context you provide upfront, the faster we can help. This page will help you solve common issues yourself and, if you still need support, give us what we need to diagnose your problem quickly.

Before You Contact Us​

Flagsmith is fully open source. You can read the code, trace the logic, and find the answer yourself. AI coding assistants can help you navigate the codebase quickly - point them at the Flagsmith repo or the relevant SDK repo and ask your question.

Beyond that, many issues have already been solved. A quick search can save you time:

What We Need From You​

When you do reach out, including the right information from the start makes a big difference. Here's what helps us depending on your issue type.

SDK or API Issues​

  • Which SDK and exact version number
  • Are you using a server-side or client-side environment key?
  • Your initialisation code and flag evaluation code (sanitised)
  • What you expected to happen vs what actually happened
  • Exact error messages, stack traces, or console output

Self-Hosted Infrastructure​

  • Flagsmith version (Docker image tag, e.g. v2.221.1)
  • Deployment method and version (Helm chart version, Docker Compose, etc.)
  • Relevant Helm values or Docker configuration (sanitised - remove secrets)
  • Database type and version (PostgreSQL version, managed vs self-hosted)
  • Container logs from the relevant service (API, task processor, SSE). For Docker: docker logs <container_name>. For Kubernetes: kubectl logs <pod_name> -c <container_name>. Include the full output, not just the error line - context around the error often matters.
  • For real-time/SSE issues: Redis configuration details
  • For upgrade issues: which version you upgraded from and to

Dashboard or UI Issues​

  • Screenshot or short screen recording showing the problem
  • Steps to reproduce - what you clicked, in what order
  • Which project, environment, and flag name are affected
  • Browser and version
  • Any errors in the browser console (open with F12 -> Console tab)
  • For API/network issues: a HAR file captures the exact request/response cycle and is extremely helpful. Note: HAR files can contain sensitive data like auth tokens - sanitise before sharing.

SaaS Account or Billing Issues​

  • Your organisation name in Flagsmith
  • Which project and environment is affected
  • For billing issues: your subscription plan and the change you're requesting

Getting in Touch​

Enterprise Support​

Flagsmith Enterprise customers can also use these support channels:

  • Dedicated Customer Success manager for personalised assistance and training.
  • Shared Slack channel for real-time group support between your organisation and the Flagsmith team (available as an add-on).

Bug Reports and Pull Requests​

Flagsmith is open source, and we encourage contributions from the community. If you want to submit a specific bug report or code change, you can open an issue or pull request directly in the main repository or the relevant SDK repository listed above.

Other repositories: