Run the local RADIUS server in a container

In this topic, you will learn how to deploy the Portnox™ Cloud local RADIUS server using Docker containers.

For information about how the cloud RADIUS servers work, see the following topic: How do RADIUS servers work in Portnox Cloud?.

  1. In the Cloud portal top menu, click on the Settings option.

  2. In the right-hand side pane, find and click on the LOCAL RADIUS SERVICE heading.

    More options appear under the LOCAL RADIUS SERVICE heading and description.

  3. Under the LOCAL RADIUS INSTANCE heading, click on the Add new RADIUS profile (Docker) link to begin the configuration process for the new local server instance.

    Your browser will display the Add new Local RADIUS cluster heading with configuration fields for the new local server instance.

  4. In the Hostname field, enter a name for your local RADIUS server.

    This name is used as the hostname that your NAS devices will use to contact the local RADIUS server. However, using the IP address in NAS configuration is recommended. You will find the IP address later, in the cloud platform that you will use to run the Docker image. You can also choose a local network address if you run the Docker image on-premises.

  5. Click on the  👁  icon and hold it to note down the value of the Shared Secret field to use it when configuring NAS devices to contact this local RADIUS server.

    If you want to generate a different shared secret, click on the Regenerate link under the field.

    Note: After you save the server settings and view them, you can use the  ⧉  icon to copy the value to the clipboard.
  6. Click on the Save button to save the configuration.

    Note: If you click on the Save And Download button instead, your browser will download the ISO image with the configuration. You can set up the local RADIUS server using this ISO file but it’s more difficult and in most cases unnecessary. Instead, we recommend that you set up the local RADIUS server using the environment variables only.
  7. Click on the row that represents the newly added RADIUS server to display more information.

  8. Click on the Generate link above to generate the RADIUS_GATEWAY_TOKEN.

  9. Copy the environment variable values into a text file for later.

    Click on the  ⧉  icon next to the value to copy each value.


    You can also copy these values directly from Portnox Cloud later, when setting up your Docker instance.

    Warning: If you use the  ⧉  icon to copy the values, the value is copied along with the key name and the equal sign. Make sure to remove the prefix before pasting the value into Azure.
  10. Deploy the local RADIUS Docker image in the cloud or on-premises.