Installation using helm

Requirements

kubernetes cluster READY to run
helm command-line tool must be installed.

Installation using helm latest release 4.4

install using helm

Add the helm repo and then install it on Linux or macOS or read the step by step installation process abcdesktop for kubernetes

NAMESPACE=abcdesktop
helm repo add abcdesktop https://abcdesktopio.github.io/helm/
helm install my-abcdesktop abcdesktop/abcdesktop --version 4.4.1 --create-namespace -n ${NAMESPACE}

show details

NAME: my-abcdesktop
LAST DEPLOYED: Tue Mar 24 14:24:17 2026
NAMESPACE: abcdesktop
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
# After installation, and wait for deployments and services

NAMESPACE=abcdesktop
kubectl wait deployment -n ${NAMESPACE} --all --for condition=Available=True --timeout=300s
kubectl get services -n ${NAMESPACE}


# To connect to your abcdesktop using a port forward
- port-forwarding is only for testing
- change LOCAL_PORT if need

LOCAL_PORT=30443
NAMESPACE=abcdesktop
kubectl port-forward $(kubectl get pods -l run=router-od -o jsonpath={.items..metadata.name} -n ${NAMESPACE} ) --address 0.0.0.0 "${LOCAL_PORT}:80" -n ${NAMESPACE}

Open your web browser to http://localhost:30443

When install your helm installation process is ready, you need to forward the pod's router tcp port 80 to your localhost port 30443 (for example)

LOCAL_PORT=30443
NAMESPACE=abcdesktop
kubectl port-forward $(kubectl get pods -l run=router-od -o jsonpath={.items..metadata.name} -n ${NAMESPACE} ) --address 0.0.0.0 "${LOCAL_PORT}:80" -n ${NAMESPACE}

Video to run the quick installation process

You can watch the youtube video sample. This video describes the Quick installation process using helm.

Helm options

To modify any default parameters of the helm configuration, follow these steps:

Step 1: Retrieve the default configuration file from helm

helm show values abcdesktop/abcdesktop  > abcdesktop-values.yaml

A new file named abcdesktop-values.yaml will be created in your current directory.

imagePullSecrets: []

console:
  image: ghcr.io/abcdesktopio/console
  tag: 4.4
  replicaCount: 1
  resources:
    limits:
      cpu: 0.5
      memory: 128Mi
    requests:
      cpu: 0.1
      memory: 16Mi

memcached:
  image: ghcr.io/abcdesktopio/oc.memcached
  tag: 4.4
  replicaCount: 1
  resources:
    limits:
      cpu: 0.2
      memory: 64Mi
    requests:
      cpu: 0.1
      memory: 16Mi
...

You can edit this file to change any default parameters of helm configuration.

Warning

The values file is a YAML file, where indentation is critical.

Note

Values can evolve with helm versions, so a good practice is to keep only the changed parts.

If you want to change only the memcached docker image and console image tags and CPU limit, your abcdesktop-values.yaml may look like:

console:
  tag: 4.4
  resources:
    limits:
      cpu: 99999

memcached:
  image: ghcr.io/abcdesktopio/MY.memcached

Non-overridden values will use the default ones.

Step 2 - apply helm with your values file

Then apply your configuration:

helm install my-abcdesktop abcdesktop/abcdesktop \
    --version 4.4 \
    --create-namespace \
    -n ${NAMESPACE} \
    -f abcdesktop-values.yaml

Helm upgrade

An installed helm chart can be upgraded (both version and values) using:

helm upgrade my-abcdesktop \
    --version 4.4 \
    -f abcdesktop-values \
    -n ${NAMESPACE}