Deploying the Portal Application Using Rancher UI

This guide walks you through deploying the Portal application on a Kubernetes cluster using Rancher UI.

Step 1: Login to Rancher

  1. Navigate to your Rancher URL.
  2. Log in with your credentials.

Step 2: Select the Cluster

  1. After login, you will land on the Rancher Dashboard.
  2. Here, you’ll see all the Kubernetes clusters in your environment.
  3. Select the cluster where you want to deploy the Portal application.

Step 3: Create a Namespace

  1. Navigate to:
    Cluster > Projects/Namespaces > Create Namespace
  2. Fill in the following details:
    • Name: portal (must be in lowercase)
    • Description: portal namespace
  3. Click Create.

Step 4: Add the Helm Repository

  1. Go to:
    Apps > Repositories > Create

  2. Enter the following:
  3. Click Create.

Step 5: Install the Portal Helm Chart

  1. Go to:
    Apps > Charts
  2. Use the filter/search bar and type: portal
  3. Select the portal chart.

  4. Click Install.
  5. Set the following:
    • Namespace: portal (select from dropdown)
    • Release Name: portal (must be lowercase)
  6. Check “Customize Helm options before install”.
  7. Click Next.




    Update the values.yaml file
    Replace placeholder values with your actual configurations:

    # For Cognito
    AWS_ACCESS_KEY: Update_AWS_ACCESS_KEY_ID AWS_ACCESS_KEY_ID: Update_AWS_ACCESS_KEY_ID
    # For Secret manager
    AWS_SECRET_ACCESS_KEY: Update_AWS_SECRET_ACCESS_KEY AWS_SECRET_KEY: Update_AWS_SECRET_ACCESS_KEY COGNITO_CLIENT_ID: Update_AWS_Cognito_Client_ID COGNITO_REGION: Update_AWS_Cognito_Region COGNITO_USER_POOL_ID: Update_AWS_Cognito_User_Pool_ID OKTA_API_KEY: Update_OKTA_API_KEY
    # Secret manager name
    SECRET_BASE_NAME: Update_Secret_Manager_Name SECRET_REGION_NAME: Update_Secret_Manager_Region


  8. Click Next > Install.



Step 6: Verify the Deployment

  1. Navigate to:
    Apps > Installed Apps > portal
  2. Click on your app name to see all running services.





  3. Go to:
    Service Discovery > Services
    Open on the UI with Worker IP and port 31051.
    http://Worker/Agent IP:31051/
  4. A new tab will open with the Portal Application running.

Portal Dashboard

  • You will now see the Portal login screen.
  • After login, you’ll be redirected to the Portal Dashboard.

Optional: Delete the Installed Application

If you need to delete the application:

  1. Navigate to:
    Apps > Installed Apps
  2. In the list of installed applications, locate portal.


  3. Click on the three dots (⋮) next to it.
  4. Select Delete.
  5. Confirm by clicking Delete again.

To Reinstall the Application

Simply follow the steps outlined above starting from Step 5: Install the Portal Helm Chart.