# 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:

```sh
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:

```sh
sudo locale-gen en_US.UTF-8
```

### Set the Locale

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

```sh
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:
```sh
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
```shell
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](https://www.postgresql.org/docs/9.3/locale.html) for details.
* `lc_collate value for PostgreSQL database. en_IN.UTF-8 for India`: Similar to lc_ctype.
Refer to [PostgreSQL locale documentation](https://www.postgresql.org/docs/9.3/locale.html) 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.