Installation

  • Install Ubuntu 22.04 on your server or PC. At present, GRADIUS supports only Ubuntu 22.04.

  • Visit https://gradius.example.com and logon using your credentials. Replace the examle URL with your actual URL.

  • Visit your account dashboard and copy the instructions to install GRADIUS. The download link expires in four hours. If you want to install or re-install the application later, you have to obtain a fresh download link at the time of installation.

  • Execute the commands one by one that you copied in the previous step.

  • The installer will prompt for further details.

Preparing GRADIUS Installation

Verify the Locale

Run the locale command again to confirm the changes:

locale

You should now see UTF-8 as the encoding.

Generate the Required UTF-8 Locale

First, generate the appropriate UTF-8 locale. For example, if you need en_US.UTF-8, you can generate it using:

sudo locale-gen en_US.UTF-8

Set the Locale

Update the system locale by editing the /etc/default/locale file:

sudo vi /etc/default/locale

Add or update the following lines:

LANG=en_US.UTF-8
LC_ALL=en_US.UTF-8

Save and exit.

Reconfigure Locale

If the issue persists, you can use dpkg-reconfigure to reconfigure locales:

sudo dpkg-reconfigure locales

Select the UTF-8 locale (e.g., en_US.UTF-8) and make it the default. Or select ALL locales.

Restart the system.

Manual Installation Commands

sudo apt install wget tar
wget --output-document=install.sh https://s3.amazonaws.com/downloads.gavika.com/gradius/install.sh && chmod u+x install.sh
sudo bash install.sh --gradius-download-url <download-url>

Installation prompts

  • Use HTTPS? yes or no: Type yes if you want to use a run GRADIUS on HTTPS. Type no if you want to run GRADIUS on HTTP.

  • TLS certificate path: The path to the TLS certificate. If you are running GRADIUS on HTTP, type _.

  • TLS certificate key path: The path to TLS certificate key file. If you are running GRADIUS on HTTP, type _.

  • Web server name: The domain name for the GRADIUS instance. Could be something like gradius.yourorganization.com. If you are running GRADIUS on HTTPS, you have to provide a valid TLS certificate matching the domain name.

  • Provision PostgreSQL database server? yes or no: Type yes if you want the GRADIUS installer to install and configure PostgreSQL server. Type no, if you do not want GRADIUS installer to install and configure PostgreSQL server.

  • PostgreSQL hostname. localhost for All-in-a-box: Type localhost if you want to provision the PostgreSQL server on the same server on which GRADIUS installer is running.

  • PostgreSQL database name: The database name. Could be something like gradius.

  • lc_ctype value for PostgreSQL database. en_IN.UTF-8 for India: The lc_ctype value for the PostgreSQL database. One of the valid options is en_IN.UTF-8. Another valid example is en_US.UTF-8. Refer to PostgreSQL locale documentation for details.

  • lc_collate value for PostgreSQL database. en_IN.UTF-8 for India: Similar to lc_ctype. Refer to PostgreSQL locale documentation for details.

  • PostgreSQL username: The username used to connect to the PostgreSQL server. If GRADIUS installer is used to provision PostgreSQL, the value could be something like gradius.

  • PostgreSQL password: The password for the above PostgreSQL username. Choose a strong password if you are using GRADIUS to provision PostgreSQL server and database.

  • Redis hostname. 127.0.0.1 for all-in-box configuration: GRADIUS needs a Redis server. If you are providing a Redis server installed on another server, provide its hostname or IP address. If you want GRADIUS to provision Redis, type 127.0.0.1.

  • Redis port. Usually 6379: The Redis port. Type 6379. If your Redis instance runs on another port, type the correct port number.

  • Redis DB. Usually 1: The Redis database number. Typically, the value is 1.

  • Install Prometheus Node Exporter? yes or no:. Type yes, if you want Prometheus Node Exporter to be installed. We recommend to type yes.

  • Use HTTPS for GRADIUS user portal? yes or no: Type yes, if you want to run GRADIUS user portal on HTTPS. Type no if you want to run GRADIUS user portal on HTTP.

  • TLS certificate path for GRADIUS user portal: The path to the TLS certificate. If you are running GRADIUS user portal on HTTP, type _.

  • TLS certificate key path for GRADIUS user portal: The path to TLS certificate key file. If you are running GRADIUS user portal on HTTP, type _.

  • Web server name for GRADIUS user portal: The domain name for the GRADIUS user portal. Could be something like gradius-user.yourorganization.com. If you are running GRADIUS user portal on HTTPS, you have to provide a valid TLS certificate matching the domain name.