​
Prerequisites

  • A running Kubernetes cluster.
  • Helm 3 or above. See Installing Helm.
  • A Postgres instance
  • A Redis instance
We provide Postgres and Redis helm charts for testing and evaluation. Please do not use them in production environments

​
Steps

Add Convoy’s chart repository to Helm:

helm repo add convoy https://frain-dev.github.io/helm-charts

Update the chart repository:

helm repo update

Install the chart:

helm install --values values.yaml convoy convoy/convoy -n convoy

Upgrade the chart:

helm upgrade --values values.yaml convoy convoy/convoy -n convoy

​
Upgrading

​
Upgrading to Convoy v24.8.x (Convoy Helm charts v3.1.0)

To upgrade to Convoy v24.8.x, you need to update the charts to v3.x.x. In this release, we have gated a number of features behind a license. If you use them, these features will cease to work until you provide a license key. Read here to learn about all the paid features, and here to learn how to get a license key.

​
Upgrading the Convoy version without upgrading the chart

Change both the image tag value to the convoy version you want

values.yml
convoy:
    tag: v24.8.1

worker:
  image:
    tag: v24.8.1

ingest:
  image:
    tag: v24.8.1

stream:
  image:
    tag: v24.8.1

server:
  image:
    tag: v24.8.1

migrate:
  image:
    tag: v24.8.1

​
ArgoCD Configuration

Convoy uses helm hooks to trigger migrations every time the charts are installed or upgraded. These hooks alone won’t work for an ArgoCD installation since they are not compatible.

Helm hooks
"helm.sh/hook": post-install,post-upgrade
"helm.sh/hook-delete-policy": before-hook-creation

You can apply this ArgoCD definition to run migrations on your cluster when the chart is installed and upgraded

ArgoCD Definition
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: convoy
  namespace: argocd
  finalizers:
    - resources-finalizer.argocd.argoproj.io
spec:
  project: default
  source:
    repoURL: 'https://frain-dev.github.io/helm-charts'
    targetRevision: '2.3.0'
    chart: convoy
    helm:
      releaseName: convoy
      valuesObject:
        migrate:
          jobAnnotations:
            argocd.argoproj.io/hook: Sync
  destination:
    server: 'https://kubernetes.default.svc'
    namespace: convoy
  syncPolicy:
    syncOptions:
      - ServerSideApply=true
      - CreateNamespace=true
    automated:
      selfHeal: true
      prune: true

​
Login to your instance

Use the credentials below to sign into your freshly minted Convoy instance:

Email: [email protected] 
Password: default

Was this page helpful?

DockerTroubleshooting