Fresh Install (Podman)

1. Install prerequisite software:

   1. Includes the following software:

      1. podman

      2. podman-compose

      3. jq

      4. postgresql-client

      5. wget

      6. uidmap

      7. rootlesskit

      8. slirp4netns

   2. Commands:

      1. # Ensure repositories are up to date
         sudo apt-get update
         
         # Install the prerequisite software
         sudo apt-get install -y \
          podman \
          podman-compose \
          jq \
          postgresql-client \
          wget \
          uidmap \
          rootlesskit \
          slirp4netns

2. Add the desired user to own the Polarity Server container processes:

   1. We use the polarityd user, with UID:GID 31337:31337 by default.

      1. # Add the user to the system
         sudo useradd -u 31337 -U -m -d /app -s /bin/bash polarityd
         
         # Set the new user's password
         sudo passwd polarityd
         
         # Set user's ownership over home directory
         sudo chown -R polarityd: /app

3. Prepare the Polarity Server process owner to execute the installation script:

   1. Allow Polarity Server process owner to maintain ownership without an active session:

      1. sudo loginctl enable-linger 31337

   2. Add the Polarity Server process owner to the adm and sudo groups:

      1. # Verify polarityd's current group membership
         sudo groups polarityd
         ## example output - "polarityd: polarityd"
         
         # IF polarityd is NOT in the adm and sudo groups, add them
         sudo groupmod -a -U polarityd adm
         sudo groupmod -a -U polarityd sudo
         
         # Re-verify polarityd's group membership
         sudo groups polarityd
         ## example output - "polarityd: polarityd adm sudo"

4. Download the Polarity Server installation script and execute it (as the process owner):

   1. Switch user to the Polarity Server process owner:

      1. sudo su - polarityd

   2. Script may have a filename in the format install-<web.version>-<server.version>-offline-selfextract.sh (or similar).

      1. wget https://<download.url>/install-5.5.0-5.5.1-offline-selfextract.sh

      2. You can get the URL from your Customer Success team.

   3. Make the script executable:

      1. chmod u+x ./install-5.5.0-5.5.1-offline-selfextract.sh

   4. Add your Polarity license file to the same directory as the install script.

   5. Execute the script as the process owner (ie. do not use sudo):

      1. ./install-5.5.0-5.5.1-offline-selfextract.sh

      2. You may be prompted a few times for the process owner’s password (to make system changes, etc.).

   6. If Docker is installed, the script will automatically choose Docker as the container engine.  To force the script to use Podman instead, prepend execution with CONTAINER_ENGINE=podman:

      1. CONTAINER_ENGINE=podman ./install-5.5.0-5.5.1-offline-selfextract.sh

Installation will fail if your Polarity License file is not in the same directory as the installation script.