# Install Cytomine on Kubernetes

TIP

If you experiment any issues, please describe your problem precisely in our ticket system on Github. (opens new window)

WARNING

This Helm chart is under active development and may be unstable. Use it at your own risk!

# Prerequisites

# Installation

  1. Clone the cytomine repository:

    git clone https://github.com/cytomine/cytomine.git
    cd cytomine
    
    1
    2
  2. Configure the mandatory values in cytomine/helm/charts/cytomine/values.yaml:

    # Your domain name
    global:
      domainName: null
    
    1
    2
    3

    All other values can use the default settings.

  3. Install the Cytomine Helm chart with a release name cytomine in the namespace cytomine-production:

    helm install cytomine helm/charts/cytomine -n cytomine-production --create-namespace
    
    1

    TIP

    cytomine can be changed to another release name.

    cytomine-production can be changed to another namespace.

# Upgrade Cytomine

To upgrade Cytomine to the latest version:

  1. Fetch the latest changes in the cytomine repository:

    cd cytomine
    git pull
    
    1
    2
  2. Upgrade to the latest version:

    helm upgrade cytomine helm/charts/cytomine -n cytomine-production
    
    1

# Uninstallation

To uninstall Cytomine in Kubernetes:

helm uninstall cytomine -n cytomine-production
1
Last Updated: 10/16/2025, 2:22:49 PM