Deploying GreenRADIUS on Ubuntu 20/24

Prerequisites

• An Ubuntu 20/24 server
• Ensure the network interface is configured with a static IP, netmask, gateway, and DNS
• The update package for GreenRADIUS 6.1.15.15 or later

Steps

1. Log in as a user with sudo access.
2. Run sudo apt-get update
3. Run sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common
4. Run curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
5. Run sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
6. Run sudo apt-get install docker-ce docker-ce-cli containerd.io
7. Run sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-Linux-x86_64" -o /usr/local/bin/docker-compose
8. Run sudo chmod +x /usr/local/bin/docker-compose
9. Create a symlink to to this path with sudo ln -s /usr/local/bin/docker-compose/usr/bin/docker-compose
10. Run sudo apt-get install unzip net-tools
11. Run sudo adduser gradmin
12. Run sudo adduser gradmin sudo
13. Run sudo chmod -R 750 /home/gradmin
14. Run sudo chown -R gradmin:gradmin /home/gradmin
15. Reboot and log in as the gradmin user.
16. Run sudo su
17. Run mkdir /home/gradmin/temp
18. Run cd /home/gradmin/temp
19. Copy the GreenRADIUS update package to the /home/gradmin/temp directory of the Ubuntu instance.
20. For the following commands, replace xxxx with the version number of the GreenRADIUS update package:
21. Run sudo unzip GreenRADIUS_xxxx_Update.zip
22. Run sudo tar -xvzf GreenRADIUS_xxxx_Update/images.tgz -C .
23. Run sudo tar -xvzf GreenRADIUS_xxxx_Update/others.tgz -C .
24. Run sudo docker load -i images/greenradius_xxxx_init_image
25. Run sudo docker load -i images/greenradius_xxxx_main_image
26. Run sudo docker load -i images/greenradius_xxxx_openldap_image
27. Run sudo docker load -i images/greenradius_xxxx_postgres_image
28. Run sudo docker load -i images/greenradius_xxxx_rsyslog_image
29. Run sudo docker load -i images/greenradius_xxxx_freeradius_image
30. Run sudo docker load -i images/greeenradius_xxxx_grs_queue_image
31. Run sudo docker load -i images/greenradius_xxxx_grs_auth_app_image
32. Run sudo mkdir -p /home/gradmin/grs-docker-compose
33. Run sudo cp others/docker-compose.yml /home/gradmin/grs-docker-compose/
34. Run cd /home/gradmin/grs-docker-compose
35. Run sudo docker-compose up -d
36. Once the previous step completes, the web administration console should be visible if you navigate to the server's IP address or hostname in your browser. Keep in mind that GreenRADIUS does not serve HTTP for security reasons; if you are getting Connection Refused errors, make sure the scheme is set to HTTPS.
37. Run sudo touch /etc/systemd/system/grs-docker-compose-app.service
38. Edit the file and insert the following:

[Unit]
Description=Docker Compose Application Service
Requires=docker.service
After=docker.service

[Service]
Type=oneshot
RemainAfterExit=yes
WorkingDirectory=/home/gradmin/grs-docker-compose
ExecStart=/usr/local/bin/docker-compose up -d
ExecStop=/usr/local/bin/docker-compose down
TimeoutStartSec=0

[Install]
WantedBy=multi-user.target

39. Save the file.
40. Run sudo systemctl enable grs-docker-compose-app
41. Run sudo systemctl start grs-docker-compose-app.service
42. Run sudo bash -c 'rm -rf /home/gradmin/temp/*'

The installation is now complete.

For installing subsequent GreenRADIUS updates:

In the following steps, replace xxxx with the version number of the new update.

1. Copy the GreenRADIUS update package to the /home/gradmin/temp directory.
2. Log in as gradmin.
3. Run sudo apt-get update
4. Run sudo apt-get upgrade
5. Run cd /home/gradmin/temp/
6. Run sudo unzip GreenRADIUS_xxxx_Update.zip
7. Run sudo tar -xvzf GreenRADIUS_xxxx_Update/images.tgz -C .
8. Run sudo tar -xvzf GreenRADIUS_xxxx_Update/others.tgz -C .
9. If upgrading from 5.2.11.11 or lower, run

• sudo nash others/scripts/system_upgrade_docker.sh
• cd /home/gradmin/grs-docker-compose
• sudo docker-compose down
• sudo bash -c 'rm -rf /usr/local/bin/docker-compose/usr/bin/docker-compose
• sudo curl -L "https://github.com/docker/compose/releases/download/v5.0.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
• Create a symlink to this path with sudo ls -s /usr/local/bin/docker-compose /usr/bin/docker-compose
• sudo chmod +x /usr/local/bin/docker-compose
• sudo docker compose up -d
• cd /home/gradmin/temp

10. Run sudo docker load -i images/greenradius_xxxx_init_image
11. Run sudo docker load -i images/greenradius_xxxx_main_image
12. Run sudo docker load -i images/greenradius_xxxx_openldap_image
13. Run sudo docker load -i images/greenradius_xxxx_postgres_image
14. Run sudo docker load -i images/greenradius_xxxx_rsyslog_image
15. Run sudo docker load -i images/greenradius_xxxx_grs_queue_image
16. Run sudo docker load -i images/greenradius_xxxx_freeradius_image
17. Run sudo docker load -i images/greenradius_xxxx_grs_auth_app_image
18. Run cd /home/gradmin/grs-docker-compose
19. Run sudo docker-compose down
20. Run sudo cp /home/gradmin/temp/others/docker-compose.yml .
21. Run sudo docker-compose up -d

To start or stop the containers:

Before starting or stopping the containers, make sure you are in the grs-docker-compose directory with cd /home/gradmin/grs-docker-compose.

Start the containers

sudo docker-compose up -d

Stop the containers

sudo docker-compose down