Fresh Install

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 around 50 users:

• 4 Cores
• 32 GB of RAM
• 250 GB storage
  • ensure wherever /app is installed 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

Amazon Linux 2

Docker / JQ / Postgres / WGET

yum install docker jq postgresql wget -y

Docker Compose 

These commands install Docker Compose and add the path to your user's default PATH.

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

echo 'export PATH="$PATH:/usr/local/bin"' >> ~/.bashrc
source ~/.bashrc

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

JQ / 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 / 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

Download and Execute the Self-Extracting Installation Script

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