# 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

Git (opens new window) (v2.0+ recommended)
Helm (opens new window) (v3.0+ recommended)
A Kubernetes cluster

# Installation

Clone the cytomine repository:

git clone https://github.com/cytomine/cytomine.git
cd cytomine

1
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.
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:

Fetch the latest changes in the cytomine repository:
```
cd cytomine
git pull
```
1
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

← Uninstallation