The broker version 3.0.1 and upwards ships as a single static binary.
Prerequisites
Britive supports Windows services and Linux OS, which supports the systemd services for running the broker as a service.
A broker can run on any modern CPU with a RAM requirement of 100 MB.
The broker requires an outbound HTTPS (TCP port 443) connection to the Britive SaaS platform. Configure your firewall or security group to allow outbound/egress traffic to https://${britive.tenant.subdomain}.britive-app.com. This enables the broker to establish and maintain connectivity with your Britive tenant.
https://<tenant_subdomain>.britive-app.com: bootstrap and API calls.
The MQTT messaging endpoint returned by the bootstrap (a *.britive-app.com host): a long-lived MQTT-over-TLS connection.
If your resource types use scripts stored on the Britive platform (remote scripts), the broker downloads them from presigned AWS S3 URLs; allow egress to those as well.
For example, if the scripts are stored on an AWS S3 bucket named resource-permission-data.s3.us-west-2.amazonaws.com, then the security group configuration must explicitly allow access to this endpoint.
Keep the following values ready from the Britive admin console:
Your tenant subdomain (for example: acme.us-east part of the tenant URL https://acme.us-east.britive-app.com).
A broker pool authentication token, created here: Manage a Broker Pool. The token identifies the pool the broker joins; any number of brokers can share a pool token.
Find out the architecture of the operating system so that the required broker can be downloaded.
Supported Platforms
Platform | Architectures | Packages |
|---|---|---|
Windows (Server or desktop) | x64, ARM64 | MSI installer, zip |
Red Hat / Rocky / Amazon Linux / Fedora | x86_64, aarch64 | rpm |
Debian / Ubuntu | amd64, arm64 | deb |
Alpine | x86_64, aarch64 | apk |
Arch Linux | x86_64, aarch64 | pkg.tar.zst |
Any other Linux | x86_64, aarch64 | tar.gz |
Downloading the broker
Log in to Britive.
Click on System admin -> Brokers and Broker Pools.
Click on the Download Brokers button.
Expand the package type to view available installers, and click on the required broker installer (version 3.0.1 upwards) to download the package depending on the operating system and architecture. Users can also copy the link, allowing them to download the broker from a location other than the local machine or browser. For example, for Microsoft Windows installer, either download Britive Broker 3.0.1-amd64.msi or Britive Broker 3.0.1-arm64.msi.
Install the broker on the required OS: