====== Getting Started ======
  * RADIUSdesk now features a **Setup Wizard** to get you up and running in no time.
  * After you created a site using the Setup Wizard you can simply start to point RADIUS Clients to the RADIUSdesk server.
  * In this page we will assume you have an installation of CoovaChilli which you want to point to a RADIUSdesk server.
  * There will be three steps involved
     - Configure CoovaChilli to point to RADIUSdesk
     - Add CoovaChilli as a Dynamic RADIUS Client
     - Add an entry to the Dynamic Keys of the Dynamic Login Page to server the login page you desire.

Plain and simple. Lets get started.

===== Configure CoovaChilli to point to RADIUSdesk =====
  * We assume you have a standard install of CoovaChilli which is configured by the /etc/chilli/config file
  * You can look at this page as reference [[getting_started:20_install_ubuntu_coovachilli|Install CoovaChilli on Ubuntu 20.04]]
  * We will assume the following for our RADIUSdesk server

^ Item      ^ Value      ^ Comment         ^
| IP Address    | 164.160.91.12    | This does not need to be a public IP and can even be internal        |
| FQDN    | hotspot.radiusdesk.com | Looks more professional and needed if serving through https  |
| NAS Identifier    | ZA-GTNG-JHB-1     | Work out a convention that works for you    |

  * Edit the /etc/chilli/config file
<code bash>
sudo vi /etc/chilli/config
</code>
  * Modify the following items
<code bash>
HS_NASID=ZA-GTNG-JHB-1
HS_RADIUS=164.160.91.12
#HS_RADIUS2=localhost
HS_UAMFORMAT=http://hotspot.radiusdesk.com/cake3/rd_cake/dynamic-details/chilli-browser-detect/
</code>
  * Save the changes and restart CoovaChilli
<code bash>
sudo systemctl stop chilli
sudo systemctl start chilli
sudo systemctl statue chilli
</code>

===== Add CoovaChilli as a Dynamic RADIUS Client =====
  * After you made your changes to CoovaChilli, pointing it to RADIUSdesk the Dynamic RADIUS Client should be already waiting for you under the Unknown RADIUS Clients, how cool is that!
  - Log into RADIUSdesk
  - Go to RADIUS
  - Look for the blue button with the question mark and click it to open the **Unknown Clients** Tab
  - Select the item which you want to add, click the **Attach** button show the attach window.
  - Supply the required info (Remember to specify the Realms you want to enable for this NAS)
  - Click save and the NAS should now move from the **Unknown Clients** to **RADIUS Clients**

One step remaining and we're done!

===== Add Dynamic Keys =====
  - Log into RADIUSdesk
  - Go to Login Pages
  - Select the Login Page you want to serve on the CoovaChilli Captive Portal
  - Edit the page and go to the **Dynamic Keys** sub tab
  - Click the add button and specify 
        - name: nasid
        - value: ZA-GTNG-JHB-1
        - priority: 1
  - Save the entry

Everything should now be ready to use the Captive Portal :-)