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 Cloud portal left-hand side menu, click on the Services > LOCAL RADIUS SERVICE > Local RADIUS images option.

  3. Optional: Under the Local RADIUS images heading, click on the Docker image link to open a new browser tab with the Docker Hub page for the portnox/portnox-radius Docker image.

    Keep this browser tab open. It may be useful when you configure the Docker image later.

  4. Scroll down to the Local RADIUS instance section and on the bottom of this section, click on the Add new RADIUS profile (Docker) link.

  5. 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.

  6. Click on the  ⧉  icon next to the Shared Secret field to copy the shared secret and paste it into a temporary text file. You will need to use this shared secret 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.

  7. Click on the Save button to save the configuration.

  8. Click on the row that represents the newly added RADIUS server to display more information.

  9. Copy the environment variable values into a temporary text file for later.
    1. Click on the  ⧉  Copy command link below the Docker command to copy the command to the clipboard.
    2. Paste the command into a text editor of your choice.
    3. Copy the following values from the command and paste them into a separate temporary text file.
      • RADIUS_GATEWAY_ORG_ID=value_of_the_gateway_org_id
      • RADIUS_GATEWAY_PROFILE=value_of_the_gateway_profile
      • RADIUS_GATEWAY_TOKEN=value_of_the_gateway_token
    Note:
    If you will be deploying the Docker container on-premises on Linux, macOS, or Windows, simply paste and run the command. If you are deploying the Docker container in a cloud environment such as Microsoft Azure, Amazon Web Services, or Google Cloud Platform, you will need these values and must provide them as instructed in the corresponding deployment guides (see below).
  10. Deploy the local RADIUS Docker image in the cloud or on-premises.