Server Setup

Describes how to install Privacy Screen on your system.

Installing Cobalt Privacy Screen

Cobalt distributes a docker-compose file that orchestrates three docker images, one for each of the following services:

  • Privacy Screen Server (frontend for accepting text / audio streams)
  • Transcribe Server (for recognizing text in audio files)
  • Redaction Backend Engine (for redacting text data)
flowchart LR; A[SDK] <--> |Audio and/or Text| B[Privacy Screen Server] B[Privacy Screen Server] <--> | Audio | C[Transcribe Server] B[Privacy Screen Server] <--> | Text | D[Redaction Backend Engine]

Having these components as separate images facilitates large deployments where each image can be auto-scaled independently based on request traffic.

Installing Server

  1. Contact Cobalt to get a link to the image files in AWS S3 and the docker-compose configuration file. This link will expire in two weeks, so be sure to download the file to your own server.

  2. Download with the AWS CLI if you have it, or with curl:

    URL="the url sent by Cobalt"
FILE_NAME="name you want to give the file (should end with the same extension as the url, usually tar.bz2)"
curl $URL -L -o $FILE_NAME

  3. Untar the file, and load the docker images. The tar file will also contain the docker-compose.yaml file.

    tar -xvjf $FILE_NAME -C ./
docker load < *.bz2

  4. Copy the cobalt license file into the server folder

  5. Copy the deid license file into the server folder

  6. Start the services using docker-compose:

    docker-compose up --build

The server will be running in the container and listening on port 2728 for gRPC requests from clients.