> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cyberup24.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Application Management

Every capability on the LARK runs as a containerized application within the Kubernetes cluster. A core set is installed by default, and administrators may deploy additional applications from the appliance's pre-loaded Helm chart repositories or remove applications that are no longer required. Application lifecycle management is performed through Rancher, using Helm charts.

<Note>
  New applications are installed from Helm chart repositories already loaded on the appliance, so the underlying system remains standard while the application set is tailored to requirements. The appliance does not need to be rebuilt to add capabilities.
</Note>

## Viewing installed applications

Installed applications are viewed by opening Rancher, selecting the cluster, and navigating to **Apps** then **Installed Apps**. This view is also used to confirm the result of an install or removal.

## Installing an application

<Steps>
  <Step title="Access the Rancher dashboard">
    From a connected laptop, open a web browser and navigate to `https://rancher.apps.lark`. Sign in using Keycloak SSO credentials.
  </Step>

  <Step title="Select the cluster">
    From the Rancher dashboard, select the appliance's cluster.
  </Step>

  <Step title="Open Apps & Marketplace">
    In the cluster view, select **Apps & Marketplace**. This section provides access to the available Helm chart repositories and to the deployed applications.
  </Step>

  <Step title="Select the Helm chart">
    Browse or search for the required application. Confirm the chart source and version align with the approved, pre-loaded repositories on the appliance.
  </Step>

  <Step title="Configure the deployment">
    Click **Install** on the selected chart, then configure the required parameters, including:

    * **Namespace** (create a new namespace or select an existing one)
    * **Resource allocations** (CPU, memory)
    * **Storage configuration** (persistent volumes, if required)
    * **Service exposure settings** (ClusterIP, NodePort, etc.)
  </Step>

  <Step title="Review and deploy">
    Review all configuration values, then click **Install** to deploy the application.
  </Step>

  <Step title="Verify the deployment">
    Monitor deployment status under **Installed Apps**. Confirm that all pods reach a **Running** state. If issues are observed, review the pod logs and health indicators.
  </Step>
</Steps>

## Removing an application

Removing an application deletes its Helm release and all associated Kubernetes resources (pods, services, and related objects).

<Warning>
  Caution must be exercised when removing applications. Removing a shared or core platform component can affect the operation of the appliance. The application name and namespace must be verified before deletion to avoid removing a component the appliance depends on.
</Warning>

<Steps>
  <Step title="Access the Rancher dashboard">
    Open Rancher at `https://rancher.apps.lark` and sign in with Keycloak SSO credentials.
  </Step>

  <Step title="Open Installed Apps">
    Select the cluster, open **Apps & Marketplace**, and navigate to **Installed Apps**.
  </Step>

  <Step title="Identify the application">
    Locate the application to be removed, and verify its name and namespace.
  </Step>

  <Step title="Delete the application">
    Select the application, click **Delete** or **Uninstall**, and confirm when prompted.
  </Step>

  <Step title="Verify removal">
    Confirm the application no longer appears under **Installed Apps**. Navigate to **Workloads** to confirm all associated pods have terminated, and verify that related services and resources have been removed.
  </Step>
</Steps>
