---
title: "Amazon Linux"
slug: "installing-broker-on-linux"
updated: 2026-01-23T02:58:41Z
published: 2026-01-28T07:58:13Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.britive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Amazon Linux

## Installing Broker on Amazon Linux

1. Make sure you have completed all generic prerequisites mentioned in the [Prerequisites](/v1/docs/installing-and-configuring-broker-1#prerequisites)section.
2. Install OpenJDK 21 using the following command:

```shell
sudo dnf install java-21-amazon-corretto-devel -y
```
3. Run the following command to verify Java installation:

```shell
$ java -version
```
4. Create a user and group *britivebroker*as a best practice before installing the broker:
  1. Creating a group:

```shell
sudo groupadd britivebroker
```
  2. Creating and adding a user to the group:

```shell
sudo useradd -g britivebroker britivebroker
```
5. Install the broker using the downloaded package. If you are upgrading/updating a broker, see [Upgrading Access Broker](/v1/docs/installing-broker-on-linux#upgrading-access-broker).

```shell
sudo rpm -ivh britivrbroker.rpm
```
6. Change the directory to */opt*:

```shell
cd /opt
```
7. Verify if the owner of the folder britive-broker is britivebroker; if not, change the owner of the *britive-broker*directory:

```shell
sudo chown -R britivebroker:britivebroker britive-broker
```
8. Change directory to broker's config file:

```shell
cd /opt/britive-broker/config/
```
9. Rename the config file:

```shell
mv broker-config-template.yml broker-config.yml
```
10. Open and edit the broker configuration file (*broker-config.yml)* using vi. For more details about the configuration file, see the [Configure broker-config.yml file](/v1/docs/brokers-1#configuring-brokerconfigyml-file).

```shell
vi broker-config.yml
```
11. A list of brokers is updated on Britive after users download and install the broker package on their system.
12. Start the **Britive Broker** service:

```shell
systemctl service start britive-broker
```

## Upgrading Access Broker

1. Uninstall the Britive package for the broker and install the desired version.
2. Ensure */opt/britive-broker/conf/broker-config.yml* and */opt/britive-broker/conf/logback.xml* have not been modified after the upgrade.