Introduction

This is a very brief guide with steps necessary to install Rocky Linux or Red Hat. For this guide, we used the ISO Rocky-9.4-x86_64-minimal.iso; some steps may vary in other versions.

Steps to install OS

1. Download the ISO from the official Rocky website, upload it to your virtualization system, and boot it up.

2. Upon booting, a graphical setup wizard is displayed. Configure at least the following sections:

   1. Language, Keyboard, and Time Zone.

   2. Installation destination: Automatic partitioning. Enter and click “Done” to select this mode.

   3. Software Selection → Minimal install.

   4. Network & Host Name: enter configuration, IPv4 tab. Choose “Manual” method, then add IP addresses (the Master requires at least two interfaces when deployed with SIP Registrar, see sample screenshot).
      

      

   5. Root Password & User Creation.

      1. Recommendation: create a user (e.g., opengate) with a password and check the Administrator option. Do not activate or set a password for the root user; we will use sudo with the administrator user.

Once the installation is complete, restart the machine, eject the installation disk, and verify that it boots up and can be connected via SSH (ssh opengate@ip.ip.ip.ip, where opengate is the user configured during the installation).

Steps to install Docker

Once connected to the system console, execute the following commands:

1. If you need to modify the network configuration:

   sudo nmtui

2. Disable the firewall:

   sudo systemctl disable firewalld
   sudo systemctl stop firewalld

3. Install Docker:

   sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
   sudo dnf -y install docker-ce docker-ce-cli containerd.io docker-compose-plugin
   sudo systemctl --now enable docker

   If installing on Red Hat, the repository is different; execute these commands:

   sudo dnf config-manager --add-repo https://download.docker.com/linux/rhel/docker-ce.repo
   sudo dnf -y install docker-ce docker-ce-cli containerd.io docker-compose-plugin
   sudo systemctl --now enable docker

4. Add the user to the "docker" group (if this is not done, all Docker commands will need to be executed with sudo):

   sudo usermod -a -G docker $(whoami)

   After executing this command, it is necessary to log out and reconnect for the permissions to take effect. Logout with exit and then re-establish the SSH connection.

5. Once reconnected, verify that Docker is running with the command docker info, which will display information similar to the following:

   [opengate@localhost ~]$ docker info
   Client: Docker Engine - Community
    Version:    26.1.3
    Context:    default
    Debug Mode: false
    Plugins:
     buildx: Docker Buildx (Docker Inc.)
       Version:  v0.14.0
       Path:     /usr/libexec/docker/cli-plugins/docker-buildx
     compose: Docker Compose (Docker Inc.)
       Version:  v2.27.0
       Path:     /usr/libexec/docker/cli-plugins/docker-compose
   ...

Other OS level configuration

Multiple IP addresses

If you do not configure them using the install user interface, start the console configuration with sudo nmtui, select the appropriate connection, then use the “Add…” option inside Addresses section to add the new IP.

For Azure installations, follow the official documentation https://learn.microsoft.com/en-us/azure/virtual-network/ip-services/virtual-network-multiple-ip-addresses-portal#red-hat-enterprise-linux-and-others

NTP synchronization

By default, it is configured to sync with public servers. If you want to configure it to sync with the machine running OpenGate Proxy Server, edit the file /etc/chrony.conf, remove the public servers, and add the following instead:

server ip.ip.ip.ip iburst trust

Where ip.ip.ip.ip is the IP address of the OpenGate Proxy Server machine, where the NTP server has been previously activated (refer to the Presence installation guide).

Email service

On the OpenGate Master node, it is necessary to install "postfix" in order to send voicemails:

sudo dnf install postfix
sudo systemctl --now enable postfix

Email relay

See Configuring email relay for voicemails