Skip to main content

How to report a bug

Before submitting a bug report​

Before submitting a bug report, please:

  1. Check if the bug has already been reported in our GitHub issues
  2. Check if the bug has been discussed in our Community Forum
  3. Make sure you're using the latest version of Passbolt
  4. Try to reproduce the bug in a clean environment

How to submit a bug report​

You can submit a bug report in two ways:

Through GitHub​

  1. Go to the Passbolt API repository
  2. Click on "New issue"
  3. Select "Bug report" as the issue type
  4. Fill in the template with:
    • A clear and descriptive title
    • Steps to reproduce the bug
    • Expected behavior
    • Actual behavior
    • Screenshots or videos if applicable
    • Environment details (browser, OS, Passbolt version)
    • Any relevant logs

Through the Community Forum​

  1. Go to the Community Forum
  2. Navigate to the "Bug Reports" category
  3. Click "New Topic"
  4. Fill in:
    • A clear and descriptive title
    • Steps to reproduce the bug
    • Expected behavior
    • Actual behavior
    • Screenshots or videos if applicable
    • Environment details (browser, OS, Passbolt version)
    • Any relevant logs

What happens next?​

  1. The Passbolt team will review your report
  2. If the bug is confirmed, we'll:
    • Add it to our backlog
    • Create a GitHub issue to track progress
    • Update you on the status
  3. If we need more information, we'll:
    • Ask for additional details
    • Help you troubleshoot
    • Guide you through debugging steps

Tips for a good bug report​

  • Be specific about what went wrong
  • Include all steps to reproduce the bug
  • Provide clear and concise information
  • Include relevant error messages or logs
  • Be patient and responsive to follow-up questions