1.2. Installation of binaries on Ubuntu

This section will guide you through installation of pre-compiled binaries on Ubuntu.

Before you start, make sure that all system requirements are met.

You can install the binaries in two ways:

  • download and run our installation script that will automatically install all required components incl. auxiliary software, or

  • you can follow the installation steps one-by-one manually. The steps describe basically what the script does.


Remember to set the timezone in PostgreSQL to UTC, after you complete installation either way.

1.2.1. Installation script

To install the FRED and associated software with the installation script, follow this procedure:

# Switch to root
sudo su -
# Download the script
wget -O fred-ubuntu-install.sh https://fred.nic.cz/public/media/1568014036/56/
# Execute the script
. fred-ubuntu-install.sh

What steps the script takes is explained in the following section.

1.2.2. Installation steps

This section explains the individual steps that are taken by the installation script to install software required for the operation of the FRED.

  1. Switch to root before you begin

    sudo su -
  2. Enable the add-apt-repository command

    sudo apt update
    apt-get --assume-yes install software-properties-common  apt-transport-https
  3. Add the current CZ.NIC signing key to apt

    sudo apt-key adv --keyserver hkp://keys.gnupg.net:80 --recv-keys 0x1C0200016A9AC5C6
    sudo gpg --no-default-keyring --keyring /etc/apt/trusted.gpg --keyid-format=0xLONG --fingerprint 0x1C0200016A9AC5C6
    # zkontrolovat, ze fingerprint klice je
    # 6416 D3EA C684 1541 8DCF  EEA5 1C02 0001 6A9A C5C6
  4. Add required repositories

    add-apt-repository "http://archive.nic.cz/ubuntu/"
  5. Update apt index

    apt-get update
  6. Install the Postfix mail server

    # preset Postfix configuration
    debconf-set-selections <<< "postfix postfix/mailname string $(hostname)"
    debconf-set-selections <<< "postfix postfix/main_mailer_type string 'Internet Site'"
    apt-get --assume-yes install postfix
  7. Install the FRED package

    apt-get --assume-yes install fred
  8. Install the database schema of the FRED

    The fred-dbmanager installs table schemas and fills enumeration tables; it does NOT initialize the system with basic data – the latter is described in the System initialization section.

    su - postgres -c "/usr/sbin/fred-dbmanager install"
  9. Enable FRED sites in UWSGI

    ln -s /etc/uwsgi/apps-available/fred-rdap.ini /etc/uwsgi/apps-enabled/
    ln -s /etc/uwsgi/apps-available/fred-webwhois.ini /etc/uwsgi/apps-enabled/
    service uwsgi restart
  10. Enable FRED sites in Apache

    a2ensite 02-fred-mod-eppd-apache.conf
    a2ensite 02-fred-mod-whoisd-apache.conf
    a2enconf fred-rdap.conf
    a2enconf fred-webwhois.conf
  11. Replace mpm-event with mpm-prefork in Apache and restart


    This is a workaround for Ubuntu 16.04.

    The mod-whoisd module is not compatible with the mpm-event Apache scheme that is installed by default, so it must be disabled and replaced with mpm-prefork.

    a2dismod mpm_event
    a2enmod mpm_prefork
    service apache2 restart
  12. Some servers require the system registrar to be present in the Registry, before they can be started.

    To quickly create it, use the following command (eventually see Preparing registrars):

    fred-admin --registrar_add --handle=REG-SYSTEM --country=CZ --no_vat --system

    The default handle is REG-SYSTEM, but you may use a different handle if you specify it in the configuration options system_registrar and automatically_managed_keyset_registrar.

    You don’t need to set up EPP access for this registrar, because internal administration happens out of EPP.

  13. Start the FRED services

    service fred-rifd start
    service fred-adifd start
    service fred-pifd start
    service fred-logd start
    service fred-msgd start
    service fred-rsifd start
    service fred-akmd start
    service fred-pyfred start
    service fred-webadmin start
    service fred-backend-registry start
  14. Finished.

1.2.3. After installation

Check the system configuration and adapt it accordingly.

Before registrars can access the Registry, you must initialize it.

You may also want to test the installation.