Server requirements

Operating systems

Family Distributions Package manager

deb

Debian, Ubuntu, Linux Mint

apt-get

astra

Astra Linux

apt-get

alt

ALT Linux

apt-get over rpm

rhel

CentOS and CentOS Stream, RedOS, AlmaLinux, Rocky

dnf, on CentOS 7 — yum

The family is determined by ID from /etc/os-release, and if necessary refined by ID_LIKE — this is how Linux Mint is recognized. What is installed on each family is described in era_installer/reference-os-matrix.adoc#era-installer-os-matrix.

If the OS is not recognized, the installer stops at prechecks and changes nothing.

bash

bash version 4.2 or newer is required. The lower bound is chosen from CentOS 7, which has 4.2.46. Everything supported from the list above satisfies this requirement.

Permissions

The installer needs root: it installs packages, writes to /etc, and works with docker. It can be launched in two ways:

  • as root — then nothing additional is needed;

  • as a regular user with sudo.

In the second case the installer checks permissions with sudo -n true. If it succeeds — sudo is configured without a password — nothing is asked. If it fails, the password is asked once at the start of the apply phase, before command output starts filling the screen; in non-interactive mode there is nowhere to ask it, and the run stops. If sudo is not installed and you are not root, prechecks stop the run.

The passwordless sudo rule must apply to this user specifically, and must be checked like this:

sudo -k          # reset the password cache, otherwise the check lies
sudo -n true && echo "ok"

When parsing sudoers, the last matching rule wins. Therefore a NOPASSWD line in /etc/sudoers.d/ does not apply if below it — for example, after @includedir — there is a regular rule for the same user.

Network and addresses

The platform needs a static address that exists on a server interface. It is set by the --ipaddress key and goes into the platform configuration.

When installing over ssh, the connection address and the platform address are different things. --host says where to connect; --ipaddress says on which interface the platform will operate. They most often coincide, but are not required to.

If the specified address is not present on any interface, the installer warns about it on the confirmation screen but does not refuse to work: the address may appear later.

Ports

The installer opens in firewalld only the ports it knows for sure:

  • the PostgreSQL port (--pgport, by default 5441) — if the database is installed on this server and is accessible externally;

  • platform ports, if you set them with the --erawshttpport, --erawshttpsport, --eraerlepmdport, --eradistports, --eranodesports keys;

  • the nfs, mountd, rpc-bind services — if the server serves shared directories.

Ports that the platform opens itself are unknown to the installer: in the host network the container publishes them itself. A warning is printed about this, and they must be opened manually. Details in era_installer/reference-os-matrix.adoc#era-installer-os-matrix-firewall.

Disk space

Prechecks look at free space in the data directory and warn if it is less than 10 GiB. Planning guidelines:

  • platform image — about 1—​2 GiB in the archive and the same after loading into docker;

  • platform data grows over time and depends on load;

  • PostgreSQL cluster, if it is on the same server.

Utilities

Required on the host where installation runs: tar, grep, sed, awk, find. Their absence stops the run.

Separately, installation over ssh requires ssh and rsync — on your machine, and rsync also on the target host: the distribution is copied with it. They are checked by a separate wrapper precheck, not the general one: on the server itself installation must not refuse because of a tool it was not going to use — a clean Debian does not have rsync.

Optional but useful:

whiptail or dialog

enable pseudo-graphical mode. On Debian, Ubuntu, Linux Mint, Astra Linux, and other Debian derivatives whiptail is used, on other systems — dialog: the reason is how to exit the window, see era_installer/install-ssh.adoc#era-installer-install-ssh-keys. Without a suitable tool the installer works in text mode — this is a full mode, not an emergency one.

curl

needed when installing packages from the internet. Not required with --useapt=n.

python3

needed only by the era/scripts/gen_container_cmd.sh command.

Terminal locale

Non-English interfaces require a UTF-8 locale. If it is absent, the installer switches to English itself and reports this.

The reason is not only letters: in a non-UTF-8 locale bash counts string length in bytes, and the confirmation screen columns drift. English is ASCII and reads in any encoding.

CentOS 7 has no C.UTF-8 locale at all — this is not a configuration error but a system feature. Set LANG=en_US.UTF-8 or work in English.