Security Policy

Last Updated: November 18, 2026

The Beyond Better project takes security seriously. We appreciate your efforts to responsibly disclose your findings and are committed to addressing security issues thoroughly and promptly.

Reporting a Vulnerability

To report a security issue, please use GitHub's private vulnerability reporting in our community repository: Report a vulnerability. Include a description of the issue, steps to reproduce it, and the BB version you're using. Please don't open a public issue, and don't disclose the issue publicly until we've released a fix.

If you can't use GitHub, email admin@beyondbetter.app with "Security vulnerability report" in the subject.

The BB team will respond to your report indicating the next steps in handling your findings. After the initial reply, our security team will keep you informed of progress toward a fix and full announcement. We may also ask for additional information or guidance from you to help us understand and address the issue effectively.

Supported Versions

As BB is currently in beta, we only support the latest version with security updates. Once we reach a stable release, we will provide a table of supported versions here.

Security Update Process

Once we have confirmed a security issue, we will follow this process:

  1. Develop a fix and test it thoroughly
  2. Prepare a security advisory detailing the vulnerability and the fix
  3. Release a new version containing the fix
  4. Publish the security advisory

Best Practices for BB Users

When using BB, we recommend the following security practices:

  • Always use the latest version
  • Do not expose the BB Hub to the public internet
  • Be cautious when using BB with sensitive data or codebases
  • Regularly check for and apply updates
  • Ensure that TLS certificates are properly configured and up-to-date

TLS Security

BB includes built-in TLS certificate management for secure operation. Key security aspects include:

Certificate Management

  • Automatic certificate generation and trust store integration
  • Self-contained certificate authority (CA) creation
  • Secure certificate storage and handling
  • Automatic trust store updates

Security Features

  • TLS enabled by default for all connections
  • Automatic certificate renewal before expiry
  • Platform-specific trust store integration
  • Certificate validation and verification

Best Practices

  • Keep TLS enabled (default setting)
  • Monitor certificate expiry through status page
  • Back up certificate files when deploying
  • Use bb secure status to check certificate health

For More Information

For detailed information about certificate management, please refer to:

Thank you for helping keep BB and our users safe!

Acknowledgments

We maintain a list of security researchers who have helped improve BB's security on our Security Acknowledgments page.