Fresh Install
  • 24 Jun 2025
  • 1 Minute to read
  • Dark
    Light

Fresh Install

  • Dark
    Light

Article summary

This page walks through how to quickly install Polarity Server version 5 on a new server.

Server Requirements

We recommend the following server specs for a deployment of up to approximately 50 users:

  • 4 Cores

  • 32 GB of RAM

  • 250 GB storage

    • ensure whichever volume contains /var has enough storage for containers

Deployment Methods

  1. Amazon Machine Image (AMI)

    1. Amazon Linux 2023 

  2. Single server container deployment

    1. Supported Operating Systems:

      1. Debian-Based Distros, such as:

      2. Debian 11 / 12

      3. Ubuntu 22.04 LTS / 24.04 LTS

    2. Enterprise Linux-Based Distros, such as:

      1. RedHat Enterprise Linux 8 / 9 

      2. CentOS Stream

      3. Rocky Linux 8 / 9

      4. Oracle Linux 8 / 9

      5. Amazon Linux

  3. Single server container deployment - separating out Redis and Postgres to different servers

    1. Typically, this will be done in AWS using Elasticache and RDS

Installation Steps

Confirm Operating System

cat /etc/os-release

Install OS Dependencies

EL 8 / 9 (eg. CentOS Stream, Rocky Linux, RHEL, etc.)

Docker

dnf config-manager --add-repo=https://download.docker.com/linux/rhel/docker-ce.repo
dnf install docker-ce -y --allowerasing
systemctl enable --now docker

JQ / YQ / Postgres / WGet

dnf install -y jq postgresql wget

Docker Compose

wget https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m) -O /usr/local/bin/docker-compose
chmod -v +x /usr/local/bin/docker-compose

Debian / Ubuntu

Update Dependencies

sudo apt-get update

Docker / JQ / YQ / Postgres / WGET / Python Utils

sudo apt-get install -y docker.io jq postgresql-client wget python3-distutils-extra

Docker Compose

sudo wget https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m) -O /usr/local/bin/docker-compose
sudo chmod -v +x /usr/local/bin/docker-compose

Check Docker Components

docker --version
docker-compose --version

Warning

If either of these two programs fail and give a "command not found" error, you may need to add /usr/local/bin to your PATH or the secure_path variable in the /etc/sudoers file.

Enable Docker Service

systemctl enable --now docker 

Download and Execute the Self-Extracting Installation Script

Please reach out to your Polarity Customer Success Representative for the link. 


Was this article helpful?