---
title: "Deploying Session Recording with Docker"
slug: "deploying-session-recording-with-docker"
updated: 2026-02-26T06:40:51Z
published: 2026-02-26T07:38:08Z
canonical: "docs.britive.com/deploying-session-recording-with-docker"
---

> ## 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.

# Deploying Session Recording with Docker

Britive recommends using Docker to deploy the session recording components. The following steps show an example deployment using this method. This deployment packages the Britive broker and the session daemon under one Docker Compose configuration for a quick setup of ephemeral, recorded user sessions for RDP and SSH.

## Prerequisites

1. Docker Engine and Docker Compose are installed on the target server or virtual machine.
2. A Britive tenant with the Session Recording feature enabled.
3. A broker pool token from the Britive admin portal.
4. Network access from the session daemon to target systems on the applicable protocol ports (e.g., 3389 for RDP, 22 for SSH).

## Terminology

| Term | Definition |
| --- | --- |
| JSON Secret Key | A shared secret used for JSON-based authentication between the Britive broker and the session recording web application. Generated during setup and configured in *docker-compose.yml*. |
| Broker | The Britive Access Broker component that is packaged alongside the session daemon. Manages credential rotation and curates ephemeral user sessions. |

## Setup

1. Visit [https://github.com/britive/onboarding/tree/main/session-recording/docker](https://github.com/britive/onboarding/tree/main/session-recording/docker) and copy the directory contents to the desired server or virtual machine.
2. Update *broker-config.yml* with the desired tenant subdomain and the token for the broker bootstrap.
3. Generate a JSON secret key:
  - On macOS:

```shell
echo -n "yoursecretphrase" | md5
```
  - On Linux:

```shell
echo -n "yoursecretphrase” | md5sum
```
4. Update the *docker-compose.yml* file with the generated key:

```shell
server:
  environment: 
    JSON_SECRET_KEY: "<json secret key goes here>"
```
5. Build the Docker image:

```shell
docker build -t broker-docker
```
6. Start the services:

```shell
docker compose up
```

This completes the broker and session recording install. The broker service starts automatically, and you should see an instance of the broker running on the Britive admin portal.