### Example dpkg installation output

Source: https://www.radiusdesk.com/wiki24/install_24_4_coova?do=

Shows the expected output after running the dpkg installation command.

```text
sudo dpkg --install coova-chilli_1.8_amd64.deb
...
...
Selecting previously unselected package coova-chilli.
(Reading database ... 263113 files and directories currently installed.)
Preparing to unpack coova-chilli_1.8_amd64.deb ...
Unpacking coova-chilli (1.8) ...
Setting up coova-chilli (1.8) ...
Chilli default off. Look at /etc/default/chilli
Processing triggers for libc-bin (2.39-0ubuntu8.7) ...
Processing triggers for man-db (2.12.0-4build2) ...
```

--------------------------------

### Install and enable MariaDB

Source: https://www.radiusdesk.com/wiki24/install_22_4?do=

Install MariaDB server and PHP-MySQL driver, then enable and start the service.

```bash
sudo apt-get -y install mariadb-server php8.1-mysql
sudo systemctl enable mariadb
sudo systemctl restart mariadb
sudo systemctl status mariadb
```

--------------------------------

### Startup script example

Source: https://www.radiusdesk.com/wiki24/install_accel_rd

Example content for the /etc/rc.local startup script.

```bash
#!/bin/bash
iptables -t nat -A POSTROUTING -o wlan0 -j MASQUERADE
 
cd /etc/MESHdesk
 
sleep 10
/etc/MESHdesk/u.lua &
sleep 10
/etc/MESHdesk/heartbeat.lua &
 
exit 0
```

--------------------------------

### Install and configure PHP-FPM

Source: https://www.radiusdesk.com/wiki24/install_24_4?rev=1708425959

Install PHP-FPM and enable the service.

```bash
sudo apt-get -y install php-fpm
sudo systemctl enable php8.2-fpm
sudo systemctl start php8.2-fpm
```

--------------------------------

### Agent configuration file example

Source: https://www.radiusdesk.com/wiki24/install_accel_rd

Example configuration for /etc/accel-ppp-rd.conf.

```ini
[internet]
disabled=0
dns=cloud.radiusdesk.com
protocol=https
http_port=80
https_port=443
ip=164.160.89.129
 
[pppoe]
interface=eth0
```

--------------------------------

### Install package and configure

Source: https://www.radiusdesk.com/wiki24/install_22_4_accel?rev=1707333992

Install the generated DEB package and initialize the configuration file.

```bash
sudo dpkg -i accel-ppp.deb
```

```bash
sudo mv /etc/accel-ppp.conf.dist /etc/accel-ppp.conf
```

--------------------------------

### Install Node.js and npm

Source: https://www.radiusdesk.com/wiki24/install_22_4_mqtt

Install the necessary Node.js runtime and package manager on the server.

```bash
sudo apt install nodejs
sudo apt install npm
```

--------------------------------

### Installation notes

Source: https://www.radiusdesk.com/wiki24/install_24_4_freeradius?do=diff&rev=1766461842

Comments regarding package installation behavior.

```bash
# Answer yes to the question to install these packages with their dependencies
```

```bash
# Please note that the installation of this package generates some things that can take a lot of time on slower computers.
```

--------------------------------

### Install Nginx

Source: https://www.radiusdesk.com/wiki24/install_22_4

Install the Nginx web server.

```bash
sudo apt-get -y install nginx
```

--------------------------------

### Install Accel-ppp Package

Source: https://www.radiusdesk.com/wiki24/install_22_4_accel?difftype=sidebyside&do=diff&rev2%5B0%5D=1707333992&rev2%5B1%5D=1707406913

Install the compiled .deb package.

```bash
sudo dpkg -i accel-ppp.deb
```

--------------------------------

### View PKI initialization feedback

Source: https://www.radiusdesk.com/wiki24/install_24_4_openvpn

Example output after running the init-pki command.

```text
Notice
------
'init-pki' complete; you may now create a CA or requests.
 
Your newly created PKI dir is:
* /home/system/openvpn-ca/pki
 
Using Easy-RSA configuration:
* /home/system/openvpn-ca/vars
```

--------------------------------

### Netplan configuration example

Source: https://www.radiusdesk.com/wiki24/install_22_4

Example configuration for setting up two network interfaces as DHCP clients.

```yaml
# This file is generated from the information provided by
# the data source.  Changes to it do not persist across an instance.
# To disable the network configuration functions of cloud-init, write a file
# /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg with the following content:
# network: {config: disabled}
network:
    version: 2
    ethernets:
            enp0s3:
                    addresses: []
                    dhcp4: true
                    optional: true
            enp0s8:
                    addresses: []
                    dhcp4: true
                    optional: true
```

--------------------------------

### Install and configure PHP-FPM

Source: https://www.radiusdesk.com/wiki24/install_22_4

Install PHP-FPM 8.1 and enable the service.

```bash
sudo apt-get -y install php-fpm
sudo systemctl enable php8.1-fpm
sudo systemctl start php8.1-fpm
```

--------------------------------

### Install and configure Nginx

Source: https://www.radiusdesk.com/wiki24/install_26_4?rev=1775568720

Remove Apache, update the system, install Nginx, and manage the service state.

```bash
   sudo systemctl stop apache2.service
   sudo apt-get -y remove apache2
	
```

```bash
# Get the latest package lists
sudo apt-get update
# Update the system to the latest
sudo apt-get upgrade
```

```bash
sudo apt-get -y install language-pack-en-base
```

```bash
sudo apt-get -y install nginx
```

```bash
sudo systemctl stop nginx.service
sudo systemctl start nginx.service
```

--------------------------------

### Install language pack

Source: https://www.radiusdesk.com/wiki24/install_22_4

Install the English language pack.

```bash
sudo apt-get -y install language-pack-en-base
```

--------------------------------

### Install dependencies

Source: https://www.radiusdesk.com/wiki24/install_22_4_accel

Install required build tools and development libraries for Accel-ppp.

```bash
sudo apt-get install -y build-essential cmake gcc linux-headers-`uname -r` git libpcre3-dev libssl-dev liblua5.1-0-dev
```

--------------------------------

### Start and Verify Service

Source: https://www.radiusdesk.com/wiki24/install_22_4_mqtt

Start the service and check its current status.

```bash
sudo systemctl start rdcore-api-gateway.service
sudo systemctl status rdcore-api-gateway.service
```

--------------------------------

### Start XFRM Interface

Source: https://www.radiusdesk.com/wiki24/install_24_4_strongswan?do=diff&rev=1768150377

Starts the XFRM interface service on the server.

```bash
systemctl start xfrm0
```

--------------------------------

### Database Setup

Source: https://www.radiusdesk.com/wiki24/install_22_4?difftype=sidebyside&do=diff&rev2%5B0%5D=1707402012&rev2%5B1%5D=1726734023

Switch to root user to perform database configuration tasks.

```bash
sudo su
```

--------------------------------

### Verify installation output

Source: https://www.radiusdesk.com/wiki24/install_22_4_coova

Example output from the dpkg installation command indicating that CoovaChilli is disabled by default.

```text
Selecting previously unselected package coova-chilli.
(Reading database ... 125842 files and directories currently installed.)
Preparing to unpack coova-chilli_1.6_amd64.deb ...
Unpacking coova-chilli (1.6) ...
Setting up coova-chilli (1.6) ...
Chilli default off. Look at /etc/default/chilli
Processing triggers for libc-bin (2.31-0ubuntu9.2) ...
Processing triggers for systemd (245.4-4ubuntu3.6) ...
Processing triggers for man-db (2.9.1-1) ...
```

--------------------------------

### View dpkg installation output

Source: https://www.radiusdesk.com/wiki24/install_24_4_coova?rev=1774031462

Example output from the dpkg installation command indicating the package is disabled by default.

```text
Selecting previously unselected package coova-chilli.
(Reading database ... 125842 files and directories currently installed.)
Preparing to unpack coova-chilli_1.8_amd64.deb ...
Unpacking coova-chilli (1.8) ...
Setting up coova-chilli (1.8) ...
Chilli default off. Look at /etc/default/chilli
Processing triggers for libc-bin (2.31-0ubuntu9.2) ...
Processing triggers for systemd (245.4-4ubuntu3.6) ...
Processing triggers for man-db (2.9.1-1) ...
```

--------------------------------

### Netplan Configuration Example

Source: https://www.radiusdesk.com/wiki24/install_22_4?difftype=sidebyside&do=diff&rev2%5B0%5D=1707401189&rev2%5B1%5D=1726734023

Example configuration for disabling cloud-init network management.

```yaml
# This file is generated from the information provided by 
# the data source. Changes to it do not persist across an instance. 
# To disable the network configuration functions of cloud-init, write a file 
# /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg with the following content :
# network: {config: disabled}
network:
 optional: true
```

--------------------------------

### Install Software Properties Common

Source: https://www.radiusdesk.com/wiki24/install_24_4?difftype=sidebyside&do=diff&rev2%5B0%5D=1708425780&rev2%5B1%5D=1772609321

Installs the necessary package to manage software repositories before setting up SSL.

```bash
sudo apt-get -y install software-properties-common
```

--------------------------------

### Start and Verify OpenVPN Services

Source: https://www.radiusdesk.com/wiki24/technical/openvpn-bridges-prep-openvpn

Use systemctl to start templatized OpenVPN services and journalctl to inspect their logs for errors.

```bash
#start 101
sudo systemctl start openvpn@server_vlan_101
#check the output for any errors
journalctl -xeu openvpn@server_vlan_101.service
#start 102
sudo systemctl start openvpn@server_vlan_102
#check the output for any errors
journalctl -xeu openvpn@server_vlan_102.service
#start 103
sudo systemctl start openvpn@server_vlan_103
#check the output for any errors
journalctl -xeu openvpn@server_vlan_103.service
```

--------------------------------

### List Installed Files

Source: https://www.radiusdesk.com/wiki24/install_22_4_accel?difftype=sidebyside&do=diff&rev2%5B0%5D=1707333992&rev2%5B1%5D=1707406913

Display all files installed by the Accel-ppp package.

```bash
sudo dpkg -L accel-ppp
```

--------------------------------

### Agent Configuration Example

Source: https://www.radiusdesk.com/wiki24/install_accel_rd?do=diff&rev=1707336017

Example configuration snippet for the agent's internet interface settings.

```bash
[internet]
interface=eth0
```

--------------------------------

### Install RADIUSdesk Components

Source: https://www.radiusdesk.com/wiki24/install_24_4?rev=1708430482

Install required PHP packages and clone the RADIUSdesk repositories.

```bash
sudo apt-get -y install php-cli php-mysql php-gd php-curl php-xml php-mbstring php-intl php-sqlite3 git wget
sudo systemctl restart php8.2-fpm
```

```bash
cd /var/www
sudo git clone https://github.com/RADIUSdesk/rdcore.git
```

```bash
cd /var/www
sudo git clone https://github.com/RADIUSdesk/rd_mobile.git
```

--------------------------------

### Configure and start service

Source: https://www.radiusdesk.com/wiki24/install_22_4_accel?do=

Initialize the configuration file and manage the Accel-ppp systemd service.

```bash
sudo mv /etc/accel-ppp.conf.dist /etc/accel-ppp.conf
```

```bash
sudo systemctl start accel-ppp
sudo systemctl status accel-ppp
```

```bash
sudo systemctl enable accel-ppp
```

--------------------------------

### Install and Enable PHP-FPM Service

Source: https://www.radiusdesk.com/wiki24/install_24_4?difftype=sidebyside&do=diff&rev2%5B0%5D=1708425733&rev2%5B1%5D=1783364980

Commands to install the PHP-FPM service and enable it for system startup.

```bash
sudo apt-get -y install php-fpm
sudo systemctl enable php8.1 -fpm
sudo systemctl start php8.1 -fpm
```

```bash
sudo apt-get -y install php-fpm
sudo systemctl enable php8.3 -fpm
sudo systemctl start php8.3 -fpm
```

--------------------------------

### Install NPM Dependencies

Source: https://www.radiusdesk.com/wiki24/install_22_4_mqtt

Install the required Node.js dependencies for the gateway.

```bash
sudo npm install
```

--------------------------------

### Prepare for Let's Encrypt Installation

Source: https://www.radiusdesk.com/wiki24/install_22_4?difftype=sidebyside&do=diff&rev2%5B0%5D=1707401742&rev2%5B1%5D=1722577028

Update the package list before following external SSL installation instructions.

```bash
sudo apt-get update
```

--------------------------------

### Install Wireguard

Source: https://www.radiusdesk.com/wiki24/technical/wireguard-agent

Update package lists and install the Wireguard package.

```bash
sudo apt update
sudo apt install wireguard
```

--------------------------------

### Install MariaDB and PHP-MySQL

Source: https://www.radiusdesk.com/wiki24/install_24_4?difftype=sidebyside&do=diff&rev2%5B0%5D=1708425780&rev2%5B1%5D=1772609321

Commands to install MariaDB server and the PHP-MySQL extension.

```bash
sudo apt-get -y install mariadb-server php8.1-mysql
sudo systemctl enable mariadb
sudo systemctl restart mariadb
```

```bash
sudo apt-get -y install mariadb-server php8.3-mysql
sudo systemctl enable mariadb
sudo systemctl restart mariadb
```

--------------------------------

### Install VLAN Module

Source: https://www.radiusdesk.com/wiki24/technical/openvpn-bridges-prep-os

Installs the vlan package and ensures the 8021q module is loaded at boot.

```bash
#Install the VLAN package
sudo apt-get update
sudo apt-get install vlan
#Permanently load the module during boot time
sudo su -c 'echo "8021q" >> /etc/modules'
#Reboot the server
sudo reboot
#Confirm that it is loaded
lsmod  | grep 8021q
```

--------------------------------

### Install Network Tools

Source: https://www.radiusdesk.com/wiki24/technical/openvpn-bridges-prep-openvpn

Install the net-tools package to provide the ifconfig command.

```bash
sudo apt install net-tools
```

--------------------------------

### Install StrongSwan PKI Helper

Source: https://www.radiusdesk.com/wiki24/install_24_4_strongswan

Install the necessary helper package for managing PKI certificates.

```bash
sudo apt-get install strongswan-pki
```

--------------------------------

### Install System Dependencies

Source: https://www.radiusdesk.com/wiki24/network/firmware/prep

Install the required build tools and libraries on Ubuntu to support the OpenWRT SDK build process.

```bash
sudo apt-get update
sudo apt-get install build-essential subversion git-core libncurses5-dev zlib1g-dev gawk flex quilt libssl-dev xsltproc libxml-parser-perl unzip mercurial swig
```

--------------------------------

### Install and Configure MariaDB

Source: https://www.radiusdesk.com/wiki24/install_22_4

Install MariaDB and apply specific configurations for RADIUSdesk compatibility.

```bash
sudo apt-get -y install mariadb-server php8.1-mysql
sudo systemctl enable mariadb
sudo systemctl restart mariadb
sudo systemctl status mariadb
```

```bash
sudo vi /etc/mysql/conf.d/disable_strict_mode.cnf
```

```ini
[mysqld]
sql_mode=IGNORE_SPACE,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION
```

```bash
sudo vi /etc/mysql/conf.d/enable_event_scheduler.cnf
```

```ini
[mysqld]
event_scheduler=on
```

```bash
sudo systemctl restart mariadb
```

```bash
sudo mysql -u root 
MariaDB [(none)]> SHOW GLOBAL VARIABLES LIKE 'event_scheduler';
+-----------------+-------+
| Variable_name   | Value |
+-----------------+-------+
| event_scheduler | ON    |
+-----------------+-------+
1 row in set (0.001 sec)
```

--------------------------------

### Install Required Packages

Source: https://www.radiusdesk.com/wiki24/install_22_4

Install necessary PHP extensions and restart the PHP-FPM service.

```bash
sudo apt-get -y install php-cli php-mysql php-gd php-curl php-xml php-mbstring php-intl php-sqlite3 git wget
sudo systemctl restart php8.1-fpm
```

--------------------------------

### VLAN Configuration Files

Source: https://www.radiusdesk.com/wiki24/technical/openvpn-bridges-prep-coova

Configuration examples for specific VLAN interfaces.

```bash
HS_LANIF=br0.101            # WAN Interface toward the Internet
HS_NETWORK=10.101.0.0      # HotSpot Network (must include HS_UAMLISTEN)
HS_NETMASK=255.255.0.0   # HotSpot Network Netmask
HS_UAMLISTEN=10.101.0.1  # HotSpot IP Address (on subscriber network)
HS_UAMPORT=3990            # HotSpot UAM Port (on subscriber network)
HS_UAMUIPORT=4990          # HotSpot UAM "UI" Port (on subscriber network, for embedded portal)

HS_DYNIP=10.101.1.1
HS_DYNIP_MASK=255.255.0.0
HS_STATIP=10.101.0.1
HS_STATIP_MASK=255.255.255.0
# HS_DNS_DOMAIN=

HS_NASID=rd-vlan101
HS_SSID=rd-vlan101-ssid
```

```bash
HS_LANIF=br0.102            # WAN Interface toward the Internet
HS_NETWORK=10.102.0.0      # HotSpot Network (must include HS_UAMLISTEN)
HS_NETMASK=255.255.0.0   # HotSpot Network Netmask
HS_UAMLISTEN=10.102.0.1  # HotSpot IP Address (on subscriber network)
HS_UAMPORT=3991            # HotSpot UAM Port (on subscriber network)
HS_UAMUIPORT=4991          # HotSpot UAM "UI" Port (on subscriber network, for embedded portal)

HS_DYNIP=10.102.1.1
HS_DYNIP_MASK=255.255.0.0
HS_STATIP=10.102.0.1
HS_STATIP_MASK=255.255.255.0
```

--------------------------------

### Install software-properties-common

Source: https://www.radiusdesk.com/wiki24/install_22_4

Updates the package list and installs the necessary package to manage software repositories before setting up Let's Encrypt.

```bash
sudo apt-get update
sudo apt-get -y install software-properties-common
```

--------------------------------

### OpenVPN Server Configuration

Source: https://www.radiusdesk.com/wiki24/install_24_4_openvpn?do=diff&rev=1763466580

Example content for the /etc/openvpn/server.conf file.

```bash
port 1194
proto udp
dev tun

# --- PKI / TLS (ECC only, no DH) ---
ca ca.crt
cert server.crt
key server.key

# No "dh none" when using EC certificates
dh none

# Optional but recommended: match your Easy-RSA curve (if you set EASYRSA_CURVE)
# ecdh-curve prime256v1

# Protect and hide the control channel
tls-crypt-v2 tls-crypt-v2-server.key

# Only allow modern TLS
tls-version-min 1.2
remote-cert-eku "TLS Web Client Authentication"

# --- VPN network ---
topology subnet
server 10.8.0.0 255.255.255.0
```

--------------------------------

### Enable Accel-ppp Service

Source: https://www.radiusdesk.com/wiki24/install_22_4_accel?difftype=sidebyside&do=diff&rev2%5B0%5D=1707333992&rev2%5B1%5D=1707406913

Ensure the service starts automatically on system boot.

```bash
sudo systemctl enable accel-ppp
```

--------------------------------

### Install and Configure PHP-FPM

Source: https://www.radiusdesk.com/wiki24/install_24_4?difftype=sidebyside&do=diff&rev2%5B0%5D=1708425780&rev2%5B1%5D=1772609321

Commands to install the PHP-FPM service and manage its systemd state.

```bash
sudo apt-get -y install php-fpm
sudo systemctl enable php8.1-fpm
sudo systemctl start php8.1-fpm
```

```bash
sudo apt-get -y install php-fpm
sudo systemctl enable php8.3-fpm
sudo systemctl start php8.3-fpm
```

--------------------------------

### Execute Local Build Script

Source: https://www.radiusdesk.com/wiki24/install_docker?do=diff&rev=1707409891

Runs the local build script to initiate the setup process.

```bash
./local_build.sh
```

--------------------------------

### Install agent dependencies

Source: https://www.radiusdesk.com/wiki24/install_accel_rd

Install necessary Lua libraries and tools for the agent.

```bash
sudo apt-get install -y curl lua-socket lua-cjson luarocks
sudo luarocks install inifile
```

--------------------------------

### Remove Apache and Install Nginx

Source: https://www.radiusdesk.com/wiki24/install_22_4?rev=1707401861

Steps to remove existing Apache installations and install/start the Nginx web server.

```bash
   sudo systemctl stop apache2.service
   sudo apt-get -y remove apache2
```

```bash
# Get the latest package lists
sudo apt-get update
# Update the system to the latest
sudo apt-get upgrade
```

```bash
sudo apt-get -y install language-pack-en-base
```

```bash
sudo apt-get -y install nginx
```

```bash
sudo systemctl stop nginx.service
sudo systemctl start nginx.service
```

--------------------------------

### Server Certificate Request Feedback

Source: https://www.radiusdesk.com/wiki24/install_24_4_openvpn?do=diff&rev=1763468476

Example output showing the successful creation of private key and certificate request files.

```bash
Using Easy-RSA 'vars' configuration:
* /home/system/openvpn-ca/vars

Using SSL:
* openssl OpenSSL 3.0.13 30 Jan 2024 (Library: OpenSSL 3.0.13 30 Jan 2024)
-----
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Common Name (eg: your user, host, or server name) [server]:

Notice
------
Private-Key and Public-Certificate-Request files created.
Your files are:
* req: /home/system/openvpn-ca/pki/reqs/server.req
* key: /home/system/openvpn-ca/pki/private/server.key
```

--------------------------------

### CoovaChilli Startup Firewall Rules

Source: https://www.radiusdesk.com/wiki24/install_22_4_coova

Example /etc/chilli/ipup.sh script for setting up firewall rules and NAT.

```bash
#UAM server specified as 10.1.0.1 
iptables -I INPUT -i tun0 -p tcp -m tcp --dport 80 --dst 10.1.0.1 -j ACCEPT
iptables -I INPUT -i tun0 -p tcp -m tcp --dport 443 --dst 10.1.0.1 -j ACCEPT
iptables -I INPUT -i tun0 -p tcp -m tcp --dport 22 --dst 10.1.0.1 -j ACCEPT
iptables -I INPUT -i tun0 -p tcp -m tcp --dport 8000 --dst 10.1.0.1 -j ACCEPT
# force-add the final rule necessary to fix routing tables (Enabling NAT)
iptables -F POSTROUTING -t nat
iptables -I POSTROUTING -t nat -o $HS_WANIF -j MASQUERADE
```

--------------------------------

### Install MariaDB and PHP 8.5

Source: https://www.radiusdesk.com/wiki24/install_26_4?do=diff&rev=1775550826

Install the required database and PHP packages for the RADIUSdesk environment.

```bash
sudo apt-get -y install mariadb-server php8.5-mysql
sudo systemctl enable mariadb
sudo systemctl restart mariadb
```

--------------------------------

### Install Required Packages and Clone Repository

Source: https://www.radiusdesk.com/wiki24/install_22_4?difftype=sidebyside&do=diff&rev2%5B0%5D=1707401742&rev2%5B1%5D=1722577028

Install necessary PHP extensions and clone the rdcore repository from GitHub.

```bash
sudo apt-get -y install php-cli php-mysql php-gd php-curl php-xml php-mbstring php-intl php-sqlite3 git wget
```

```bash
sudo git clone https://github.com/RADIUSdesk/rdcore.git
```

--------------------------------

### Enable and start FreeRADIUS service

Source: https://www.radiusdesk.com/wiki24/install_22_4_freeradius

Commands to enable the service at boot and start it immediately.

```bash
sudo systemctl enable freeradius
sudo systemctl start freeradius
sudo systemctl status freeradius
```

--------------------------------

### Install OpenVPN and Easy-RSA

Source: https://www.radiusdesk.com/wiki24/install_24_4_openvpn?do=diff&rev=1763466580

Updates the package repository and installs the necessary OpenVPN and Easy-RSA packages.

```bash
sudo apt update && sudo apt upgrade -y
sudo apt install openvpn easy-rsa -y
```

--------------------------------

### Install Optional LTE Packages

Source: https://www.radiusdesk.com/wiki24/technical/lte

Installs additional utilities for modem management and LuCI integration.

```bash
opkg update
opkg install picocom qmi-utils uci-proto-qmi
```

--------------------------------

### Start and Enable OpenVPN Service

Source: https://www.radiusdesk.com/wiki24/install_24_4_openvpn?do=diff&rev=1763470053

Commands to start, enable, and check the status of the OpenVPN server service.

```bash
sudo systemctl start openvpn@server
sudo systemctl enable openvpn@server
sudo systemctl status openvpn@server
```

--------------------------------

### Configure Settings Section

Source: https://www.radiusdesk.com/wiki24/network/firmware/openwrt-meshdesk-file?do=edit

Example configuration for the settings section in the meshdesk file, defining hardware ID, interface, and LED paths.

```bash
config settings 'settings'
option hardware 'xiaomi_4a_100'
option id_if 'eth0'
option morse_led '/sys/class/leds/blue:power/brightness'
option internet_led '/sys/class/leds/yellow:power/brightness'
option internet_led_alarm '1'
option wifi_led '/dev/null'
option lan_up_file '/tmp/lan_up'
```

--------------------------------

### Install Docker and Configure Environment

Source: https://www.radiusdesk.com/wiki24/install_docker?do=diff&rev=1707333386

Commands to set the system user, adjust permissions for the Docker socket, and prepare the data directory.

```bash
USER="system"
sudo chmod 666 /var/run/docker.sock
# customize it with your own.
sudo mkdir -p /mnt/data
# make sure all future data in this folder can be created as non root
```

--------------------------------

### Copy Reference Configuration and Startup Files

Source: https://www.radiusdesk.com/wiki24/install_accel_rd?rev=1707336017

Copy the provided sample configuration and startup files to their respective system locations.

```bash
#config file for the agent
sudo cp /etc/MESHdesk/files/accel-ppp-rd.conf /etc/
#startup file. We make a backup first of the original one (of there were one)
cp /etc/rc.local /etc/rd.local.bak
sudo cp /etc/MESHdesk/files/rc.local /etc/
```

--------------------------------

### Install Accel-ppp dependencies

Source: https://www.radiusdesk.com/wiki24/technical/ppp-openwrt-compile

Run these commands within the OpenWrt directory to install the required feed packages.

```bash
#Do this under the openwrt directory 
cd openwrt
./scripts/feeds install libpcre 
./scripts/feeds install libopenssl 
./scripts/feeds install libpthread 
./scripts/feeds install librt 
./scripts/feeds install libatomic 
./scripts/feeds install libucontext 
./scripts/feeds install kmod-sched-core 
./scripts/feeds install kmod-pptp 
./scripts/feeds install kmod-pppoe 
./scripts/feeds install kmod-ppp
```

--------------------------------

### Install StrongSwan and XFRM packages

Source: https://www.radiusdesk.com/wiki24/technical/strongswan-apdesk

Commands to install the necessary StrongSwan and XFRM packages into the OpenWrt SDK.

```bash
./scripts/feeds install strongswan
./scripts/feeds install xfrm
```

--------------------------------

### Install MariaDB Server

Source: https://www.radiusdesk.com/wiki24/install_22_4?difftype=sidebyside&do=diff&rev2%5B0%5D=1707401742&rev2%5B1%5D=1722577028

Installs the MariaDB server and the PHP MySQL extension required for RADIUSdesk.

```bash
sudo apt-get -y install mariadb-server php8.1-mysql
```

--------------------------------

### Enable and start agent services

Source: https://www.radiusdesk.com/wiki24/technical/wireguard-agent

Reload systemd and start the RADIUSdesk Wireguard agent services.

```bash
sudo systemctl daemon-reload
 
sudo systemctl enable rd-wireguard-init
sudo systemctl enable rd-wireguard-heartbeat
 
sudo systemctl start rd-wireguard-init
sudo systemctl start rd-wireguard-heartbeat
```

--------------------------------

### Install RADIUSdesk Components

Source: https://www.radiusdesk.com/wiki24/install_24_4?rev=1713936461

Install required PHP packages and clone the RADIUSdesk core and mobile repositories.

```bash
sudo apt-get -y install php-cli php-mysql php-gd php-curl php-xml php-mbstring php-intl php-sqlite3 git wget
sudo systemctl restart php8.3-fpm
```

```bash
cd /var/www
sudo git clone https://github.com/RADIUSdesk/rdcore.git
```

```bash
cd /var/www
sudo git clone https://github.com/RADIUSdesk/rd_mobile.git
```

--------------------------------

### Copy configuration and startup files

Source: https://www.radiusdesk.com/wiki24/install_accel_rd

Prepare the agent configuration and backup the existing rc.local file.

```bash
#Configuration file for the agent
sudo cp /etc/MESHdesk/files/accel-ppp-rd.conf /etc/
#Startup file. We first create a backup copy of the original file (if there is one)
cp /etc/rc.local /etc/rd.local.bak
sudo cp /etc/MESHdesk/files/rc.local /etc/
```

--------------------------------

### Install wireless profile via command line

Source: https://www.radiusdesk.com/wiki24/technical/pp-windows

Adds a wireless profile from an XML file for all users.

```bash
netsh wlan add profile filename="wenley-peap.xml" user=all
```

--------------------------------

### Verify PHP Installation

Source: https://www.radiusdesk.com/wiki24/install_22_4

Create and test a PHP info file to confirm server configuration.

```bash
sudo vi /var/www/html/test.php
```

```php
<?php
    phpinfo();
?>
```

--------------------------------

### Install Language Pack and Nginx

Source: https://www.radiusdesk.com/wiki24/install_22_4?difftype=sidebyside&do=diff&rev2%5B0%5D=1707401636&rev2%5B1%5D=1726734023

Commands to install the English language base pack and the Nginx web server.

```bash
sudo apt-get -y install language-pack-en-base
sudo apt-get -y install nginx
```

--------------------------------

### Install Docker on Ubuntu

Source: https://www.radiusdesk.com/wiki24/install_docker

Installs Docker engine and compose plugins on a standard Ubuntu system and configures user permissions.

```bash
USER="system"

sudo apt-get update
sudo apt-get install -y \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt-get update
sudo apt-get -y install docker-ce docker-ce-cli containerd.io docker-compose-plugin
sudo apt-get -y install docker-compose

# Make docker run as non root
sudo usermod -aG docker $USER
sudo chmod 666 /var/run/docker.sock

# customize it with your own.
sudo mkdir -p /mnt/data
# make sure all future data in this folder can be created as non root
sudo chown  $USER:$USER /mnt/data
```

--------------------------------

### View CA creation feedback

Source: https://www.radiusdesk.com/wiki24/install_24_4_openvpn

Example output after running the build-ca command.

```text
Using Easy-RSA 'vars' configuration:
* /home/system/openvpn-ca/vars
 
Using SSL:
* openssl OpenSSL 3.0.13 30 Jan 2024 (Library: OpenSSL 3.0.13 30 Jan 2024)
 
Enter New CA Key Passphrase: 
 
Confirm New CA Key Passphrase: 
-----
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Common Name (eg: your user, host, or server name) [Easy-RSA CA]:RADIUSdesk CA
 
Notice
------
CA creation complete. Your new CA certificate is at:
* /home/system/openvpn-ca/pki/ca.crt
```

--------------------------------

### Install FreeRADIUS and Dependencies

Source: https://www.radiusdesk.com/wiki24/install_24_4_freeradius?do=diff&rev=1733940430

Commands to install necessary Perl modules, FreeRADIUS, and JSON/web utilities.

```bash
sudo apt-get -y install libdatetime-perl libdbd-mysql-perl libdigest-hmac-perl libdatetime-format-rfc3339-perl eapoltest
sudo apt-get -y install freeradius freeradius-mysql
sudo apt-get -y install libjson-perl libwww-perl
```

--------------------------------

### Install Required PHP Packages

Source: https://www.radiusdesk.com/wiki24/install_22_4?difftype=sidebyside&do=diff&rev2%5B0%5D=1707401189&rev2%5B1%5D=1722577028

Install the necessary PHP extensions and utilities required for RADIUSdesk.

```bash
sudo apt-get -y install php-cli php-mysql php-gd php-curl php-xml php-mbstring php-intl php-sqlite3 git wget
```

--------------------------------

### Initialize Database

Source: https://www.radiusdesk.com/wiki24/install_22_4?rev=1707401189

Configure time zones, create the database, and import the initial schema.

```bash
#NOTE FAILING THIS STEP will break the RADIUS graphs
#There might be some error messages in the output which is fine - no need to be alarmed
sudo su
mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root  mysql
```

```bash
sudo su
mysql -u root
create database rd;
GRANT ALL PRIVILEGES ON rd.* to 'rd'@'127.0.0.1' IDENTIFIED BY 'rd';
GRANT ALL PRIVILEGES ON rd.* to 'rd'@'localhost' IDENTIFIED BY 'rd';
exit;
```

```bash
sudo mysql -u root rd < /var/www/html/cake4/rd_cake/setup/db/rd.sql
```

--------------------------------

### Install build dependencies

Source: https://www.radiusdesk.com/wiki24/install_22_4_coova

Install the necessary packages required to build the CoovaChilli .deb package.

```bash
sudo apt-get install build-essential libssl-dev libjson-c-dev gengetopt
sudo apt install devscripts debhelper
```

--------------------------------

### Install ZeroTier package in SDK

Source: https://www.radiusdesk.com/wiki24/technical/zerotier-apdesk

Command to install the ZeroTier package into the OpenWrt SDK during the firmware build process.

```bash
./scripts/feeds install zerotier
```

--------------------------------

### Install Required LTE Packages

Source: https://www.radiusdesk.com/wiki24/technical/lte

Installs the necessary kernel modules and utilities for QMI-based LTE modems.

```bash
opkg update
opkg install kmod-mii kmod-usb-net kmod-usb-wdm kmod-usb-net-qmi-wwan uqmi
```

--------------------------------

### Enable CoovaChilli Service

Source: https://www.radiusdesk.com/wiki24/install_24_4_coova?do=diff&rev=1774031183

Command to enable the CoovaChilli service to start at boot.

```bash
#First enable the service so that it is started at boot time 
```

--------------------------------

### Configure rc.local Startup Script

Source: https://www.radiusdesk.com/wiki24/install_accel_rd?do=diff&rev=1707336017

Example template for the /etc/rc.local startup script used to initialize network settings and NAT rules.

```bash
#!/bin/bash
Line 88:
```

--------------------------------

### Enable and Start XFRM Service

Source: https://www.radiusdesk.com/wiki24/install_24_4_strongswan

Commands to enable and start the systemd service for the XFRM interface.

```bash
systemctl enable xfrm0
systemctl start xfrm0
```

--------------------------------

### Systemd service file example

Source: https://www.radiusdesk.com/wiki24/install_22_4_freeradius

Shows the lines to comment out in the systemd unit file to prevent startup issues.

```ini
[Unit]
Description=FreeRADIUS multi-protocol policy server
After=syslog.target network.target
Documentation=man:radiusd(8) man:radiusd.conf(5) http://wiki.freeradius.org/ http://networkradius.com/doc/
 
[Service]
Type=forking
PIDFile=/run/freeradius/freeradius.pid
#EnvironmentFile=-/etc/default/freeradius
#ExecStartPre=/usr/sbin/freeradius $FREERADIUS_OPTIONS -Cxm -lstdout
ExecStart=/usr/sbin/freeradius $FREERADIUS_OPTIONS
Restart=on-failure
RestartSec=5
 
[Install]
WantedBy=multi-user.target
```

--------------------------------

### Netplan Configuration File Content

Source: https://www.radiusdesk.com/wiki24/install_22_4?difftype=sidebyside&do=diff&rev2%5B0%5D=1707320712&rev2%5B1%5D=1722577028

Example structure for the Netplan configuration file.

```yaml
# This file is generated from the information provided by 
# the data source. Changes to it do not persist across an instance. 
# To disable the network configuration functions of cloud-init, write a file 
# /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg with the following content :
# network: {config: disabled}
network:
  optional: true
```

--------------------------------

### Copy startup and configuration files

Source: https://www.radiusdesk.com/wiki24/technical/wireguard-agent

Deploy the agent configuration, scripts, and systemd service files.

```bash
#config file for the agent
sudo cp /etc/MESHdesk/files/wireguard-rd.conf /etc/
#Smart Queue Management (SQM) and throttling scrip
sudo cp /etc/MESHdesk/files/cake-wg.sh /usr/local/sbin/
#Startup files
sudo cp /etc/MESHdesk/files/rd-wireguard-init.service /etc/systemd/system/
sudo cp /etc/MESHdesk/files/rd-wireguard-heartbeat.service /etc/systemd/system/
```

--------------------------------

### Wireguard agent configuration sample

Source: https://www.radiusdesk.com/wiki24/technical/wireguard-agent

Example configuration file for /etc/wireguard-rd.conf.

```ini
[internet]
disabled=0
dns=cloud.radiusdesk.com
url=cake4/rd_cake/nodes/get-config-for-node.json
status_url=cake4/rd_cake/node-reports/submit_report.json
actions_url=cake4/rd_cake/node-actions/get_actions_for.json
protocol=https
http_port=80
https_port=443
ip=164.160.89.129
interface=eth0
 
[wireguard]
interface=eth0
```

--------------------------------

### Install iptables

Source: https://www.radiusdesk.com/wiki24/install_accel_rd

Install the iptables package required for network management.

```bash
sudo apt-get install iptables
```

--------------------------------

### Install and Configure StrongSwan

Source: https://www.radiusdesk.com/wiki24/install_24_4_strongswan?do=diff&rev=1768123609

Commands to remove legacy StrongSwan components and install the recommended charon-systemd and strongswan-swanctl packages.

```bash
#Make sure the old StrongSwan versions are not installed or running
sudo systemctl disable strongswan.service
sudo systemctl stop strongswan
sudo apt-get remove strongswan-starter
sudo apt-get remove strongswan-charon
#Install the new style StrongSwan
sudo apt-get install charon-systemd strongswan-swanctl
#Enable its startup
sudo systemctl enable strongswan.service
#This will link the strongswan-swanctl
#Created symlink /etc/systemd/system/strongswan-swanctl.service → /usr/lib/systemd/system/strongswan.service.
#Created symlink /etc/systemd/system/multi-user.target.wants/strongswan.service → /usr/lib/systemd/system/strongswan.service.

#Start it up
sudo systemctl start strongswan-swanctl.service
#=== Or for the same result alternatively ===
sudo systemctl start strongswan
sudo service strongswan start

#Check Its status
sudo systemctl status strongswan-swanctl.service
#=== Or for the same result alternatively ===
sudo systemctl status strongswan
sudo service strongswan status
```

--------------------------------

### Install and Configure MariaDB

Source: https://www.radiusdesk.com/wiki24/install_24_4?rev=1708430482

Install MariaDB and disable strict SQL mode to ensure compatibility with RADIUSdesk.

```bash
sudo apt-get -y install mariadb-server php8.2-mysql
sudo systemctl enable mariadb
sudo systemctl restart mariadb
sudo systemctl status mariadb
```

```bash
sudo vi /etc/mysql/conf.d/disable_strict_mode.cnf
```

```ini
[mysqld]
sql_mode=IGNORE_SPACE,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION
```

```bash
sudo systemctl restart mariadb
```

--------------------------------

### Enable Rdcore API Gateway

Source: https://www.radiusdesk.com/wiki24/install_22_4_mqtt

Enable the service to start automatically on system boot.

```bash
sudo systemctl enable rdcore-api-gateway.service
```

--------------------------------

### Create Symbolic Links

Source: https://www.radiusdesk.com/wiki24/install_24_4?difftype=sidebyside&do=diff&rev2%5B0%5D=1708425780&rev2%5B1%5D=1772609321

Setup symbolic links for core components and mobile interfaces.

```bash
sudo ln -s ../rdcore/rd ./rd
sudo ln -s ../rdcore/cake4 ./cake4
sudo ln -s ../rdcore/login ./login
sudo ln -s ../rdcore/AmpConf/build/production/AmpConf ./conf_dev
sudo ln -s ../rd_mobile/build/production/RdMobile ./rd_mobile
sudo ln -s ../rd_connect/build/production/RdConnect ./rd_connect
```

--------------------------------

### Build and install CoovaChilli package

Source: https://www.radiusdesk.com/wiki24/install_22_4_coova

Extract the source, remove the haserl dependency from the control file, build the package, and install it.

```bash
# If you downloaded with wget
tar -xzvf 1.6.tar.gz
# If you downloaded with the browser 
tar -xzvf coova-chilli-1.6.tar.gz
cd coova-chilli-1.6/

vi debian/control
#Look for this part
#------
#Depends:
# ${shlibs:Depends},
# iptables,
# haserl,
# adduser,
#------
#------ CHANGE TO THIS (remove haserl as a dependency)
#------
#Depends:
# ${shlibs:Depends},
# iptables,
# adduser,
#-----

debuild -i -us -uc -b
cd ..
sudo dpkg --install coova-chilli_1.6_amd64.deb
```

--------------------------------

### Install and Configure MariaDB

Source: https://www.radiusdesk.com/wiki24/install_24_4

Installation commands and configuration for MariaDB, including disabling strict mode and enabling the event scheduler.

```bash
sudo apt-get -y install mariadb-server php8.3-mysql
sudo systemctl enable mariadb
sudo systemctl restart mariadb
sudo systemctl status mariadb
```

```bash
sudo vi /etc/mysql/conf.d/disable_strict_mode.cnf
```

```ini
[mysqld]
sql_mode=IGNORE_SPACE,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION
```

```bash
sudo vi /etc/mysql/conf.d/enable_event_scheduler.cnf
```

```ini
[mysqld]
event_scheduler=on
```

```bash
sudo systemctl restart mariadb
```

```bash
sudo mysql -u root 
MariaDB [(none)]> SHOW GLOBAL VARIABLES LIKE 'event_scheduler';
+-----------------+-------+
| Variable_name   | Value |
+-----------------+-------+
| event_scheduler | ON    |
+-----------------+-------+
1 row in set (0.001 sec)
```

--------------------------------

### Update System and Install Nginx

Source: https://www.radiusdesk.com/wiki24/install_22_4?difftype=sidebyside&do=diff&rev2%5B0%5D=1707401189&rev2%5B1%5D=1726734023

Update package lists and install the Nginx web server along with necessary language packs.

```bash
# Get the latest package lists
sudo apt-get upgrade
```

```bash
sudo apt-get -y install language-pack-en-base
sudo apt-get -y install nginx
```

--------------------------------

### Initialize Database

Source: https://www.radiusdesk.com/wiki24/install_22_4

Configure time zones, create the database, and populate it with initial data.

```bash
#NOTE FAILING TO DO THIS STEP will break the RADIUS graphs
#Some error messages may appear in the output, which is not a problem - no need to worry
sudo su
mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root  mysql
```

```bash
sudo su
mysql -u root
create database rd;
GRANT ALL PRIVILEGES ON rd.* to 'rd'@'127.0.0.1' IDENTIFIED BY 'rd';
GRANT ALL PRIVILEGES ON rd.* to 'rd'@'localhost' IDENTIFIED BY 'rd';
exit;
```

```bash
sudo mysql -u root rd < /var/www/html/cake4/rd_cake/setup/db/rd.sql
```

--------------------------------

### Install RADIUSdesk Mobile on Server

Source: https://www.radiusdesk.com/wiki24/getting_started/mobile_ui

Commands to clone the repository and link the build directory to the web server root.

```bash
cd /var/www
sudo git clone https://github.com/RADIUSdesk/rd_mobile.git
cd /var/www/html/
sudo ln -s ../rd_mobile/build/production/RdMobile ./rd_mobile
```

--------------------------------

### Build and install CoovaChilli package

Source: https://www.radiusdesk.com/wiki24/install_24_4_coova?do=

Extracts source, modifies dependencies in the control file, builds the .deb package, and installs it.

```bash
# Extract the package
tar -xjf coova-chilli-1.8.tar.bz2
# Change to working directory
cd coova-chilli-1.8/
# Edit the control file
vi debian/control
#Look for this part
#------
#Depends:
# ${shlibs:Depends},
# iptables,
# haserl,
# adduser,
#------
#------ CHANGE TO THIS (remove haserl as a dependency)
#------
#Depends:
# ${shlibs:Depends},
# iptables,
# adduser,
#-----
 
debuild -i -us -uc -b
cd ..
sudo dpkg --install coova-chilli_1.8_amd64.deb
```

--------------------------------

### Install Systemd Service File

Source: https://www.radiusdesk.com/wiki24/install_22_4_mqtt

Copy the service file to the systemd directory to enable background execution.

```bash
sudo cp /opt/Rdcore-API-Gateway/rdcore-api-gateway.service /lib/systemd/system/
```

--------------------------------

### Install and Configure StrongSwan Service

Source: https://www.radiusdesk.com/wiki24/install_24_4_strongswan

Commands to remove legacy packages, install the modern StrongSwan components, and manage the service lifecycle.

```bash
#Make sure the old StrongSwan versions are not installed or running
sudo systemctl disable strongswan.service
sudo systemctl stop strongswan
sudo apt-get remove strongswan-starter
sudo apt-get remove strongswan-charon
#Install the new style StrongSwan
sudo apt-get install charon-systemd strongswan-swanctl
#Enable its startup
sudo systemctl enable strongswan.service
#This will link the strongswan-swanctl
#Created symlink /etc/systemd/system/strongswan-swanctl.service → /usr/lib/systemd/system/strongswan.service.
#Created symlink /etc/systemd/system/multi-user.target.wants/strongswan.service → /usr/lib/systemd/system/strongswan.service.
 
#Start it up
sudo systemctl start strongswan-swanctl.service
#=== Or for the same result alternatively ===
sudo systemctl start strongswan
sudo service strongswan start
 
#Check Its status
sudo systemctl status strongswan-swanctl.service
#=== Or for the same result alternatively ===
sudo systemctl status strongswan
sudo service strongswan status
```

--------------------------------

### View PKI Initialization Feedback

Source: https://www.radiusdesk.com/wiki24/install_24_4_openvpn?do=diff&rev=1763466580

Displays the output confirming the successful initialization of the PKI directory.

```bash
Notice
------
'init-pki' complete; you may now create a CA or requests.

Your newly created PKI dir is:
* /home/system/openvpn-ca/pki

Using Easy-RSA configuration:
* /home/system/openvpn-ca/vars
```

--------------------------------

### Compile and package

Source: https://www.radiusdesk.com/wiki24/install_22_4_accel?do=

Compile the source code and generate a DEB package for installation.

```bash
sudo make
```

```bash
sudo cpack -G DEB
```

--------------------------------

### Bridge Interface Setup Script

Source: https://www.radiusdesk.com/wiki24/technical/openvpn-bridges-prep-openvpn

Script to initialize the bridge interface when the OpenVPN tap device comes up.

```bash
sudo vi /etc/openvpn/up.sh
```

```bash
#!/bin/sh
 
BR=$1
ETHDEV=$2
TAPDEV=$3
 
/sbin/ip link set "$TAPDEV" up
/sbin/ip link set "$ETHDEV" promisc on
/sbin/brctl addif $BR $TAPDEV
```

```bash
sudo chmod 755 /etc/openvpn/up.sh
```

--------------------------------

### Configure Custom Startup in rc.local

Source: https://www.radiusdesk.com/wiki24/technical/openvpn-bridges-prep-coova

Adds OpenVPN and CoovaChilli startup commands to /etc/rc.local to ensure the correct initialization order.

```bash
#Add the startup of OpenVPN
systemctl start openvpn@server_vlan_101
systemctl start openvpn@server_vlan_102
systemctl start openvpn@server_vlan_103
 
#Add the startup of CoovaChilli
systemctl start chilli
 
exit 0
```

--------------------------------

### Install Rd-Connect

Source: https://www.radiusdesk.com/wiki24/technical/pp-connect

Commands to clone the Rd-Connect repository and create a symbolic link for the mobile UI.

```bash
cd /var/www
sudo git clone https://github.com/RADIUSdesk/rd_connect.git
cd /var/www/html
#For the RD-Connect Mobile UI
sudo ln -s ../rd_connect/build/production/RdConnect ./rd_connect
```

--------------------------------

### Install Bridge Utilities

Source: https://www.radiusdesk.com/wiki24/technical/openvpn-bridges-prep-os

Installs the bridge-utils package required for managing network bridges.

```bash
#Install the bridge-utils package
sudo apt-get update
sudo apt-get install bridge-utils
```

--------------------------------

### Update and install feeds

Source: https://www.radiusdesk.com/wiki24/network/firmware/meshdesk

Register the newly added Luci application with the OpenWrt SDK.

```bash
#cd to the working directory
cd ./openwrt
scripts/feeds update -i
#Install the package to make it visible 
scripts/feeds install luci-app-meshdesk
```

--------------------------------

### Configure swanctl.conf

Source: https://www.radiusdesk.com/wiki24/install_24_4_strongswan?rev=1768135313

Example configuration for a StrongSwan connection using a JSON-like structure.

```text
connections {
    xfrm-gw {
 
        local_addrs = %any
        remote_addrs = %any
        pools = rw_pool
        # XFRM interface binding - CRITICAL
        if_id_in = 100
        if_id_out = 100
        version = 2
        proposals = aes128-sha1-modp2048
        local {
            auth = pubkey
            certs = server.crt
            id = cloud.radiusdesk.com
         }
        remote {
            auth = pubkey
      }
      children {
        xfrm-gw {
          local_ts  = 0.0.0.0/0
          remote_ts = 0.0.0.0/0
          if_id_in  = 100
          if_id_out = 100
          esp_proposals =  aes128-sha1-modp2048
          start_action = start
          dpd_action = restart
        }
      }
      send_cert = always
      dpd_delay = 30s
      rekey_time = 1h
      #send_certreq = no
    }
}
pools {
    rw_pool {
      addrs = 10.3.1.0/16
    }
}
```

--------------------------------

### Install RADIUSdesk Mobile on Server

Source: https://www.radiusdesk.com/wiki24/getting_started/mobile_ui?do=diff&rev=1707503466

Commands to navigate to the web directory and create a symbolic link for the RADIUSdesk Mobile build.

```bash
cd /var/www
sudo ln -s ../rd_mobile/build/production/RdMobile ./rd_mobile
```

--------------------------------

### OpenWrt PPPoE client configuration

Source: https://www.radiusdesk.com/wiki24/technical/ppp-pppoe-basic

Example /etc/config/network file for an OpenWrt client connecting via PPPoE.

```text
config interface 'loopback'
        option device 'lo'
        option proto 'static'
        option ipaddr '127.0.0.1'
        option netmask '255.0.0.0'
 
config device
        option name 'br-lan'
        option type 'bridge'
        list ports 'wan'
 
config interface 'lan'
        option device 'br-lan'
        option proto 'pppoe'
        option username 'dirk'
        option password 'testing123'
```

--------------------------------

### Enable and Start CoovaChilli Service

Source: https://www.radiusdesk.com/wiki24/install_22_4_coova?difftype=sidebyside&do=diff&rev2%5B0%5D=1707321457&rev2%5B1%5D=1707407729

Commands to enable the service for boot-time startup and to initiate the service immediately.

```bash
sudo systemctl enable chilli
sudo systemctl start chilli
```

--------------------------------

### Manage Accel-ppp Service

Source: https://www.radiusdesk.com/wiki24/install_22_4_accel?difftype=sidebyside&do=diff&rev2%5B0%5D=1707333992&rev2%5B1%5D=1707406913

Commands to start and check the status of the Accel-ppp service.

```bash
sudo systemctl start accel-ppp
sudo systemctl status accel-ppp
```