This repository contains "official" plugins for the BunkerWeb solution. If you don't already know BunkerWeb, you should first read the documentation.
The installation of external plugins is covered in the plugins section of the documentation.
Each plugin is located in a subdirectory of this repository. A README file located in each subdirectory contains documentation about the plugin. Here is the list :
Release 1.12 supports BunkerWeb 1.6.14. The compatibility declaration applies to all 11 plugins listed above. Historical declarations are preserved in COMPATIBILITY.json; older BunkerWeb versions have not been revalidated for 1.12.
To prepare a release, run bash misc/update_version.sh <version> from the repository
root and add the matching version to COMPATIBILITY.json, listing the BunkerWeb
versions validated by the integration suite. CI checks that every plugin uses the
same version and that its compatibility entry includes the resolved BunkerWeb tag.
After Tests succeeds on main, a maintainer creates and pushes a signed annotated
tag matching the plugin version (for example, v1.12). The signing key must be
registered with the maintainer's GitHub account so GitHub can verify the signature.
CI holds no private signing key.
The tag push triggers the release workflow. It requires the tag to match the version
and current main commit, a verified signature targeting that commit, and a successful
Tests push run on main for that exact commit. Lightweight, unsigned, and mismatched
tags are rejected. An existing release or draft is left alone; otherwise the workflow
creates a draft with generated release notes for a maintainer to review and publish.
We offer professional services related to BunkerWeb like :
- Consulting
- Support
- Custom development
- Partnership
Please contact us at contact [@] bunkerity.com if you are interested.
To get free community support you can use the following media :
- The #help channel of BunkerWeb in the Discord server
- The help category of GitHub discussions
- The /r/BunkerWeb subreddit
- The Server Fault and Super User forums
Please don't use GitHub issues to ask for help, use it only for bug reports and feature requests.
This project is licensed under the terms of the GNU Affero General Public License (AGPL) version 3.
If you would like to contribute to the plugins you can read the contributing guidelines to get started.
We take security bugs as serious issues and encourage responsible disclosure, see our security policy for more information.