ArangoDB Kubernetes Operator

August 24, 2026 · View on GitHub

The ArangoDB Kubernetes Operator (kube-arangodb) is a set of operators that you deploy in your Kubernetes cluster to:

Manage deployments of the ArangoDB database
Manage backups
Provide PersistentVolumes on local storage of your nodes for optimal storage performance.
Configure ArangoDB Datacenter-to-Datacenter Replication

Each of these uses involves a different custom resource:

Use an ArangoDeployment resource to create an ArangoDB database deployment.
Use an ArangoMember resource to observe and adjust individual deployment members.
Use an ArangoBackup and ArangoBackupPolicy resources to create ArangoDB backups.
Use an ArangoLocalStorage resource to provide local PersistentVolumes for optimal I/O performance.
Use an ArangoPlatformChart and ArangoProfile resources to customize ArangoDB Platform deployments.

Continue with Using the ArangoDB Kubernetes Operator to learn how to install the ArangoDB Kubernetes operator and create your first deployment.

State

The ArangoDB Kubernetes Operator is Production ready.

Documentation

Limits

Limit	Description	Community	Enterprise
Cluster size limit	Limits of the nodes (DBServers & Coordinators) supported in the Cluster mode	64	1024

Beginning with Version 0.3.11 we maintain a production readiness state for individual new features, since we expect that new features will first be released with an "alpha" or "beta" readiness state and over time move to full "production readiness".

Operator will support Kubernetes versions supported on providers and maintained by Kubernetes. Once version is not supported anymore it will go into "Deprecating" state and will be marked as deprecated on Minor release.

Kubernetes versions starting from 1.18 are supported and tested, charts and manifests can use API Versions which are not present in older versions.

The following table has the general readiness state, the table below covers individual newer features separately.

Platform	State	Kubernetes Version	ArangoDB Version	Remarks	Provider Remarks
Google GKE	Production	1.28-1.34	>= 3.11.0	Don't use micro nodes
	EOL	1.25-1.27	3.9.0-3.10.0	Don't use micro nodes
	NotSupported	< 1.25	< 3.8.0	Don't use micro nodes
Azure AKS	Production	1.28-1.34	>= 3.11.0
	EOL	1.25-1.27	3.9.0-3.10.0
	NotSupported	< 1.25	< 3.8.0
Amazon EKS	Production	1.28-1.34	>= 3.11.0		Amazon EKS
	EOL	1.25-1.27	3.9.0-3.10.0		Amazon EKS
	NotSupported	< 1.25	< 3.8.0		Amazon EKS
IBM Cloud	Production	1.29-1.31	>= 3.11.0
	EOL	1.25-1.28	3.9.0-3.10.0
	NotSupported	< 1.25	< 3.8.0
OpenShift	Production	4.11-4.17	>= 3.11.0
	EOL	4.2-4.11	3.9.0-3.10.0
	NotSupported	< 4.2	< 3.8.0
BareMetal (kubeadm)	Production	1.28-1.34	>= 3.11.0
	EOL	1.25-1.27	3.9.0-3.10.0
	NotSupported	< 1.25	< 3.8.0
Minikube	Devel Only	1.28-1.34	>= 3.11.0
	EOL	1.25-1.27	3.9.0-3.10.0
	NotSupported	< 1.25	< 3.8.0
Other	Production	1.28-1.34	>= 3.11.0
	EOL	1.25-1.27	3.9.0-3.10.0
	NotSupported	< 1.25	< 3.8.0

Operator Features

Feature	Operator Version	Introduced	ArangoDB Version	ArangoDB Edition	State	Enabled	Flag	Remarks
ArangoDeployment Status Subresource	1.5.0	1.5.0	>= 3.8.0	Community, Enterprise	Production	False	--deployment.feature.enable-arango-deployment-status	Ensures the status subresource on the ArangoDeployment v1 CRD when enabled; when disabled the operator leaves it as the chart ships it (neither adds nor removes it)
Backup Policy Until Propagation	1.4.4	1.4.4	>= 3.8.0	Community, Enterprise	Alpha	True	--deployment.feature.backup-policy-until-propagation	Sets Until field in the Backup based on next schedule time
Central Services	1.4.4	1.4.4	>= 3.8.0	Enterprise	Alpha	False	--deployment.feature.central-services	Enables Central Services
Harden ArangoDB Server Containers	1.4.4	1.4.4	>= 3.8.0	Community, Enterprise	Alpha	False	--deployment.feature.harden	Adds hardening arguments to the ArangoDB server containers
JWT Asymmetric Key	1.4.4	1.4.4	>= 3.8.0	Community, Enterprise	Alpha	False	--deployment.feature.jwt-asymmetric-key	Uses Asymmetric Key as a default in ArangoDB
Random Pod Names	1.4.4	1.4.4	>= 3.8.0	Community, Enterprise	Alpha	False	--deployment.feature.random-pod-names	Enables generating random pod names
Replace Migration	1.4.4	1.4.4	>= 3.8.0	Community, Enterprise	Alpha	True	--deployment.feature.replace-migration	During member replacement shards are migrated directly to the new server
Sensitive Information Protection	1.4.4	1.4.4	>= 3.8.0	Community, Enterprise	Alpha	False	--deployment.feature.sensitive-information-protection	Hide sensitive information from metrics and logs
Gateway Sidecar	1.4.2	1.4.2	>= 3.8.0	Enterprise	Production	False	--deployment.feature.gateway-sidecar	Enables Gateway Integration
ArangoPlatform OpenID SSO	1.2.49	1.2.49	>= 3.8.0	Community, Enterprise	Beta	True	N/A	Support for ArangoPlatform SSO with OpenID
ArangoPlatform OpenID SSO Refresh	1.2.49	1.2.49	>= 3.8.0	Community, Enterprise	Alpha	True	N/A	Support for ArangoPlatform SSO with OpenID Refresh
ArangoPlatform	1.2.49	1.2.43	>= 3.8.0	Community, Enterprise	Beta	True	N/A	ArangoPlatform Solution with support for ArangoDeployment Gateway Group
Gateway	1.2.43	1.2.43	>= 3.8.0	Community, Enterprise	Production	True	--deployment.feature.gateway	Defines if gateway extension is enabled
Cleanup Imported Backups	1.2.41	1.2.41	>= 3.8.0	Community, Enterprise	Production	False	--deployment.feature.backup-cleanup	Cleanup backups created outside of the Operator and imported into Kubernetes ArangoBackup
Upscale resources spec in init containers	1.2.36	1.2.36	>= 3.8.0	Community, Enterprise	Production	True	--deployment.feature.init-containers-upscale-resources	Upscale resources spec to built-in init containers if they are not specified or lower
Create backups asynchronously	1.2.35	1.2.41	>= 3.8.0	Community, Enterprise	Production	True	--deployment.feature.async-backup-creation	Create backups asynchronously to avoid blocking the operator and reaching the timeout
Enforced ResignLeadership	1.2.34	1.2.34	>= 3.8.0	Community, Enterprise	Production	True	--deployment.feature.enforced-resign-leadership	Enforce ResignLeadership and ensure that Leaders are moved from restarted DBServer
Copy resources spec to init containers	1.2.33	1.2.33	>= 3.8.0	Community, Enterprise	Production	True	--deployment.feature.init-containers-copy-resources	Copy resources spec to built-in init containers if they are not specified
Rebalancer V2	1.2.31	1.2.31	>= 3.10.0	Community, Enterprise	Alpha	False	--deployment.feature.rebalancer-v2	N/A
Secured containers	1.2.31	1.2.31	>= 3.8.0	Community, Enterprise	Alpha	False	--deployment.feature.secured-containers	If set to True Operator will run containers in secure mode
Version Check V2	1.2.31	1.2.31	>= 3.8.0	Community, Enterprise	Alpha	False	--deployment.feature.upgrade-version-check-v2	Enable initContainer with pre version check based by Operator
Operator Ephemeral Volumes	1.2.31	1.2.2	>= 3.8.0	Community, Enterprise	Beta	False	--deployment.feature.ephemeral-volumes	N/A
Agency Poll	1.2.30	1.2.30	>= 3.8.0	Community, Enterprise	Production	True	--deployment.feature.agency-poll	Enable Agency Poll for Enterprise deployments
Local Volume Replacement Check	1.2.28	1.2.28	>= 3.8.0	Community, Enterprise	Production	False	--deployment.feature.local-volume-replacement-check	Replace volume for local-storage if volume is unschedulable (ex. node is gone)
Force Rebuild Out Synced Shards	1.2.27	1.2.27	>= 3.8.0	Community, Enterprise	Production	False	--deployment.feature.force-rebuild-out-synced-shards	It should be used only if user is aware of the risks.
Spec Default Restore	1.2.25	1.2.21	>= 3.8.0	Community, Enterprise	Beta	True	--deployment.feature.deployment-spec-defaults-restore	If set to False Operator will not change ArangoDeployment Spec
Version Check	1.2.23	1.1.4	>= 3.8.0	Community, Enterprise	Production	True	--deployment.feature.upgrade-version-check	N/A
Timezone Management	1.2.16	1.2.16	>= 3.8.0	Community, Enterprise	Production	False	--deployment.feature.timezone-management	Enable timezone management for pods
Restart Policy Always	1.2.14	1.2.14	>= 3.8.0	Community, Enterprise	Production	False	--deployment.feature.restart-policy-always	Allow to restart containers with always restart policy
Failover Leader service	1.2.13	1.2.13	< 3.12.0	Community, Enterprise	Production	False	--deployment.feature.failover-leadership	N/A
Graceful Restart	1.2.5	1.0.7	>= 3.8.0	Community, Enterprise	Production	True	---deployment.feature.graceful-shutdown	N/A
Short Pod Names	1.2.4	1.2.4	>= 3.8.0	Community, Enterprise	Production	False	--deployment.feature.short-pod-names	Enable Short Pod Names
Optional Graceful Restart	1.2.0	1.2.5	>= 3.8.0	Community, Enterprise	Production	False	--deployment.feature.optional-graceful-shutdown	N/A
Operator Internal Metrics Exporter	1.2.0	1.2.0	>= 3.8.0	Community, Enterprise	Production	True	--deployment.feature.metrics-exporter	N/A
Operator Maintenance Management Support	1.2.0	1.0.7	>= 3.8.0	Community, Enterprise	Production	True	--deployment.feature.maintenance	N/A
Encryption Key Rotation Support	1.2.0	1.0.3	>= 3.8.0	Enterprise	NotSupported	False	--deployment.feature.encryption-rotation	N/A
TLS Runtime Rotation Support	1.1.0	1.0.4	>= 3.8.0	Enterprise	Production	True	--deployment.feature.tls-rotation	N/A
JWT Rotation Support	1.1.0	1.0.3	>= 3.8.0	Enterprise	Production	True	--deployment.feature.jwt-rotation	N/A
Operator Single Mode	1.0.4	1.0.4	>= 3.8.0	Community, Enterprise	Production	False	--mode.single	Only 1 instance of Operator allowed in namespace when feature is enabled
TLS SNI Support	1.0.3	1.0.3	>= 3.8.0	Enterprise	Production	True	--deployment.feature.tls-sni	N/A
ActiveFailover Support	1.0.0	1.0.0	< 3.12.0	Community, Enterprise	Production	True	--deployment.feature.active-failover	N/A
Disabling of liveness probes	0.3.11	0.3.10	>= 3.8.0	Community, Enterprise	Production	True	N/A	N/A
Pod Disruption Budgets	0.3.11	0.3.10	>= 3.8.0	Community, Enterprise	Production	True	N/A	N/A
Prometheus Metrics Exporter	0.3.11	0.3.10	>= 3.8.0	Community, Enterprise	Production	True	N/A	Prometheus required
Sidecar Containers	0.3.11	0.3.10	>= 3.8.0	Community, Enterprise	Production	True	N/A	N/A
Volume Claim Templates	0.3.11	0.3.10	>= 3.8.0	Community, Enterprise	Production	True	N/A	N/A
Volume Resizing	0.3.11	0.3.10	>= 3.8.0	Community, Enterprise	Production	True	N/A	N/A

Operator Enterprise Only Features

To upgrade to the Enterprise Edition, you need to get in touch with the ArangoDB team. Contact us for more details.

Feature	Operator Version	Introduced	ArangoDB Version	ArangoDB Edition	State	Enabled	Flag	Remarks
AgencyCache	1.2.30	1.2.30	>= 3.8.0	Enterprise	Production	True	N/A	Enable Agency Cache mechanism in the Operator (Increase limit of the nodes)
Member Maintenance Support	1.2.25	1.2.16	>= 3.8.0	Enterprise	Production	True	N/A	Enable Member Maintenance during planned restarts
Rebalancer	1.2.15	1.2.5	>= 3.8.0	Enterprise	Production	True	N/A	N/A
TopologyAwareness	1.2.4	1.2.4	>= 3.8.0	Enterprise	Production	True	N/A	N/A

Flags

Flags:
      --action.PVCResize.concurrency int                       Define limit of concurrent PVC Resizes on the cluster (default 32)
      --agency.refresh-delay duration                          The Agency refresh delay (0 = no delay) (default 500ms)
      --agency.refresh-interval duration                       The Agency refresh interval (0 = do not refresh)
      --agency.retries int                                     The Agency retries (0 = no retries) (default 1)
      --api.basic-secret-name string                           Name of secret containing username + password for login to the dashboard (default "arangodb-operator-credentials")
      --api.grpc-port int                                      gRPC API port to listen on (default 8728)
      --api.http-port int                                      HTTP API port to listen on (default 8528)
      --api.secondary-name stringArray                         Secondary names for a certificate
      --api.tls-ca-secret-name string                          Name of secret containing ca.crt & ca.key for HTTPS API (if does not exist, new one is generated) (default "arangodb-operator-ca")
      --backup-concurrent-uploads int                          Number of concurrent uploads per deployment (default 4)
      --chaos.allowed                                          Set to allow chaos in deployments. Only activated when allowed and enabled in deployment
      --crd.install                                            Install missing CRD if access is possible (default true)
      --crd.preserve-unknown-fields stringArray                Controls which CRD should have enabled preserve unknown fields in validation schema <crd-name>=<true/false>. To apply for all, use crd-name 'all'.
      --crd.validation-schema stringArray                      Overrides default set of CRDs which should have validation schema enabled <crd-name>=<true/false>. To apply for all, use crd-name 'all'.
      --deployment.feature.active-failover                     Support for ActiveFailover mode - Required ArangoDB >= 3.8.0, < 3.12 (default true)
      --deployment.feature.agency-poll                         Enable Agency Poll for Enterprise deployments - Required ArangoDB >= 3.8.0 (default true)
      --deployment.feature.all                                 Enable ALL Features
      --deployment.feature.async-backup-creation               Create backups asynchronously to avoid blocking the operator and reaching the timeout - Required ArangoDB >= 3.8.0 (default true)
      --deployment.feature.backup-cleanup                      Cleanup imported backups if required - Required ArangoDB >= 3.8.0
      --deployment.feature.backup-policy-until-propagation     Sets Until field in the Backup based on next schedule time - Required ArangoDB >= 3.8.0 (default true)
      --deployment.feature.central-services                    Enables Central Services - Required ArangoDB EE >= 3.8.0
      --deployment.feature.deployment-spec-defaults-restore    Restore defaults from last accepted state of deployment - Required ArangoDB >= 3.8.0 (default true)
      --deployment.feature.enable-arango-deployment-status     Ensures the status subresource on the ArangoDeployment v1 CRD when enabled; when disabled the operator leaves it as the chart ships it (neither adds nor removes it) - Required ArangoDB >= 3.8.0
      --deployment.feature.enforced-resign-leadership          Enforce ResignLeadership and ensure that Leaders are moved from restarted DBServer - Required ArangoDB >= 3.8.0 (default true)
      --deployment.feature.ephemeral-volumes                   Enables ephemeral volumes for apps and tmp directory - Required ArangoDB >= 3.8.0
      --deployment.feature.failover-leadership                 Support for leadership in fail-over mode - Required ArangoDB >= 3.8.0, < 3.12
      --deployment.feature.gateway                             Defines if gateway extension is enabled - Required ArangoDB >= 3.8.0 (default true)
      --deployment.feature.gateway-sidecar                     Enables Gateway Integration - Required ArangoDB EE >= 3.8.0
      --deployment.feature.harden                              Adds hardening arguments to the ArangoDB server containers - Required ArangoDB >= 3.8.0
      --deployment.feature.init-containers-copy-resources      Copy resources spec to built-in init containers if they are not specified - Required ArangoDB >= 3.8.0 (default true)
      --deployment.feature.init-containers-upscale-resources   Copy resources spec to built-in init containers if they are not specified or lower - Required ArangoDB >= 3.8.0 (default true)
      --deployment.feature.jwt-asymmetric-key                  Uses Asymmetric Key as a default in ArangoDB - Required ArangoDB >= 3.12.8
      --deployment.feature.local-storage.pass-reclaim-policy   [LocalStorage] Pass ReclaimPolicy from StorageClass instead of using hardcoded Retain - Required ArangoDB >= 3.8.0
      --deployment.feature.local-volume-replacement-check      Replace volume for local-storage if volume is unschedulable (ex. node is gone) - Required ArangoDB >= 3.8.0
      --deployment.feature.random-pod-names                    Enables generating random pod names - Required ArangoDB >= 3.8.0
      --deployment.feature.replace-migration                   During member replacement shards are migrated directly to the new server - Required ArangoDB >= 3.8.0 (default true)
      --deployment.feature.restart-policy-always               Allow to restart containers with always restart policy - Required ArangoDB >= 3.8.0
      --deployment.feature.secured-containers                  Create server's containers with non root privileges. It enables 'ephemeral-volumes' feature implicitly - Required ArangoDB >= 3.8.0
      --deployment.feature.sensitive-information-protection    Hide sensitive information from metrics and logs - Required ArangoDB >= 3.8.0
      --deployment.feature.short-pod-names                     Enable Short Pod Names - Required ArangoDB >= 3.8.0
      --deployment.feature.timezone-management                 Enable timezone management for pods - Required ArangoDB >= 3.8.0
      --deployment.feature.tls-sni                             TLS SNI Support - Required ArangoDB EE >= 3.8.0 (default true)
      --deployment.feature.upgrade-version-check               Enable initContainer with pre version check - Required ArangoDB >= 3.8.0 (default true)
      --deployment.feature.upgrade-version-check-v2            Enable initContainer with pre version check based by Operator - Required ArangoDB >= 3.8.0
      --features-config-map-name string                        Name of the Feature Map ConfigMap (default "arangodb-operator-feature-config-map")
      --http1.keep-alive                                       If false, disables HTTP keep-alives and will only use the connection to the server for a single HTTP request (default true)
      --http1.transport.dial-timeout duration                  Maximum amount of time a dial will wait for a connect to complete (default 30s)
      --http1.transport.idle-conn-timeout duration             Maximum amount of time an idle (keep-alive) connection will remain idle before closing itself. Zero means no limit (default 1m30s)
      --http1.transport.idle-conn-timeout-short duration       Maximum amount of time an idle (keep-alive) connection will remain idle before closing itself. Zero means no limit (default 100ms)
      --http1.transport.keep-alive-timeout duration            Interval between keep-alive probes for an active network connection (default 1m30s)
      --http1.transport.keep-alive-timeout-short duration      Interval between keep-alive probes for an active network connection (default 100ms)
      --http1.transport.max-idle-conns int                     Maximum number of idle (keep-alive) connections across all hosts. Zero means no limit (default 100)
      --http1.transport.tls-handshake-timeout duration         Maximum amount of time to wait for a TLS handshake. Zero means no timeout (default 10s)
      --image.discovery.timeout duration                       Timeout for image discovery process (default 1m0s)
      --internal.scaling-integration                           Enable Scaling Integration
      --kubernetes.burst int                                   Burst for the k8s API (default 256)
      --kubernetes.max-batch-size int                          Size of batch during objects read (default 256)
      --kubernetes.qps float32                                 Number of queries per second for k8s API. If set to 0 or less, API calls won't be throttled (default 32)
      --leader.label.skip                                      Skips Leader Label for the Pod
      --log.format string                                      Set log format. Allowed values: 'pretty', 'JSON'. If empty, default format is used (default "pretty")
      --log.level stringArray                                  Set log levels in format <level> or <logger>=<level>. Possible loggers: action, agency, arangod-request, assertion, authz-pool-client, backup-operator, backup-policy-operator, chaos-monkey, cli-utils, collector, connector-v1, crd, deployment, deployment-ci, deployment-reconcile, deployment-resilience, deployment-resources, deployment-storage, deployment-storage-pc, deployment-storage-service, generic-parent-operator, grpc-service, helm, http, inspector, integration-authn-v1, integration-authorization-v1, integration-config-v1, integration-envoy-auth-v3, integration-envoy-auth-v3-impl-auth-bearer, integration-envoy-auth-v3-impl-auth-cookie, integration-envoy-auth-v3-impl-custom-openid, integration-envoy-auth-v3-impl-pass-mode, integration-events-v1, integration-meta-v1, integration-pong-v1, integration-scheduler-v2, integration-shutdown-v1, integration-storage-v1-s3, integration-storage-v2, integrations, k8s-client, kubernetes, kubernetes-access, kubernetes-admission, kubernetes-client, kubernetes-informer, monitor, networking-route-operator, operator, operator-v2, operator-v2-event, operator-v2-worker, panics, permission-role-user-binding-operator, permission-token-operator, permission-token-webhook, platform-chart-operator, platform-link-operator, platform-pod-shutdown, platform-service-operator, platform-storage-operator, pod_compare, root, root-event-recorder, scheduler-batchjob-operator, scheduler-cronjob-operator, scheduler-deployment-operator, scheduler-pod-operator, scheduler-profile-operator, sidecar, sidecar-authz, sidecar-authz-pool, sidecar-service-client-authentication, webhook (default [info])
      --log.sampling                                           If true, operator will try to minimize duplication of logging events (default true)
      --log.stdout                                             If true, operator will log to the stdout (default true)
      --memory-limit uint                                      Define memory limit for hard shutdown and the dump of goroutines. Used for testing
      --metrics.excluded-prefixes stringArray                  List of the excluded metrics prefixes
      --mode.single                                            Enable single mode in Operator. WARNING: There should be only one replica of Operator, otherwise Operator can take unexpected actions
      --operator.backup                                        Enable to run the ArangoBackup operator
      --operator.deployment                                    Enable to run the ArangoDeployment operator
      --operator.networking                                    Enable to run the Networking operator
      --operator.platform                                      Enable to run the Platform operator
      --operator.reconciliation.retry.count int                Count of retries during Object Update operations in the Reconciliation loop (default 25)
      --operator.reconciliation.retry.delay duration           Delay between Object Update operations in the Reconciliation loop (default 1s)
      --operator.scheduler                                     Enable to run the Scheduler operator
      --operator.storage                                       Enable to run the ArangoLocalStorage operator
      --operator.version                                       Enable only version endpoint in Operator
      --reconciliation.delay duration                          Delay between reconciliation loops (<= 0 -> Disabled)
      --shutdown.delay duration                                The delay before running shutdown handlers (default 2s)
      --shutdown.timeout duration                              Timeout for shutdown handlers (default 30s)
      --threads int                                            Number of the worker threads (default 16)
      --timeout.agency duration                                The Agency read timeout (default 10s)
      --timeout.arangod duration                               The request timeout to the ArangoDB (default 5s)
      --timeout.arangod-check duration                         The version check request timeout to the ArangoDB (default 2s)
      --timeout.backup-arangod duration                        The request timeout to the ArangoDB during backup calls (default 30s)
      --timeout.backup-upload duration                         The request timeout to the ArangoDB during uploading files (default 5m0s)
      --timeout.force-delete-pod-grace-period duration         Default period when ArangoDB Pod should be forcefully removed after all containers were stopped - set to 0 to disable forceful removals (default 15m0s)
      --timeout.k8s duration                                   The request timeout to the kubernetes (default 2s)
      --timeout.license-manager duration                       The request timeout for the ArangoDB License Manager API calls (default 30s)
      --timeout.pod-scheduling-grace-period duration           Default period when ArangoDB Pod should be deleted in case of scheduling info change - set to 0 to disable (default 15s)
      --timeout.reconciliation duration                        The reconciliation timeout to the ArangoDB CR (default 2m0s)
      --timeout.shard-rebuild duration                         Timeout after which particular out-synced shard is considered as failed and rebuild is triggered (default 1h0m0s)
      --timeout.shard-rebuild-retry duration                   Timeout after which rebuild shards retry flow is triggered (default 4h0m0s)
      --webhook.enabled                                        Enable integrated webhook server
      --webhook.mutating stringArray                           Mutating webhook which should have injected internal CA
      --webhook.validating stringArray                         Validating webhook which should have injected internal CA

Installation and Usage

Docker images:

Community Edition: arangodb/kube-arangodb:1.4.4
Enterprise Edition: arangodb/kube-arangodb-enterprise:1.4.4

Installation of latest release using Kubectl

This procedure can also be used for upgrades and will not harm any running ArangoDB deployments.

Community Edition

kubectl apply -f https://raw.githubusercontent.com/arangodb/kube-arangodb/1.4.4/manifests/arango-crd.yaml
kubectl apply -f https://raw.githubusercontent.com/arangodb/kube-arangodb/1.4.4/manifests/arango-deployment.yaml
# To use `ArangoLocalStorage`, also run
kubectl apply -f https://raw.githubusercontent.com/arangodb/kube-arangodb/1.4.4/manifests/arango-storage.yaml

Enterprise Edition

kubectl apply -f https://raw.githubusercontent.com/arangodb/kube-arangodb/1.4.4/manifests/enterprise-crd.yaml
kubectl apply -f https://raw.githubusercontent.com/arangodb/kube-arangodb/1.4.4/manifests/enterprise-deployment.yaml
# To use `ArangoLocalStorage`, also run
kubectl apply -f https://raw.githubusercontent.com/arangodb/kube-arangodb/1.4.4/manifests/enterprise-storage.yaml

Installation of latest release using kustomize

Installation using kustomize looks like installation from yaml files, but user is allowed to modify namespace or resource names without yaml modifications.

It is recommended to use kustomization instead of handcrafting namespace in yaml files - kustomization will replace not only resource namespaces, but also namespace references in resources like ClusterRoleBinding.

See manifests/kustomize directory for available combinations of installed features.

Community Edition example

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: my-custom-namespace
resources:
  - https://github.com/arangodb/kube-arangodb/manifests/kustomize/crd?ref=1.4.4
  - https://github.com/arangodb/kube-arangodb/manifests/kustomize/deployment?ref=1.4.4

Enterprise Edition example

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: my-custom-namespace
resources:
  - https://github.com/arangodb/kube-arangodb/manifests/kustomize-enterprise/crd?ref=1.4.4
  - https://github.com/arangodb/kube-arangodb/manifests/kustomize-enterprise/deployment?ref=1.4.4

Installation of latest release using Helm

Only use this procedure for clean installation of the operator. For upgrades see next section

From Chart Repository

Chart Installation

# Add helm repository
helm repo add kube-arangodb https://arangodb.github.io/kube-arangodb

Community Edition

# The following will install the operator and basic CRDs resources.
helm install --generate-name kube-arangodb/kube-arangodb
# To use `ArangoLocalStorage`, set field `operator.features.storage` to true
helm install --generate-name kube-arangodb/kube-arangodb --set "operator.features.storage=true"

Enterprise Edition

helm install --generate-name kube-arangodb/kube-arangodb-enterprise
# To use `ArangoLocalStorage`, set field `operator.features.storage` to true
helm install --generate-name kube-arangodb/kube-arangodb-enterprise --set "operator.features.storage=true"

From Chart Release

Community Edition

# The following will install the operator and basic CRDs resources.
helm install --generate-name https://github.com/arangodb/kube-arangodb/releases/download/1.4.4/kube-arangodb-1.4.4.tgz
# To use `ArangoLocalStorage`, set field `operator.features.storage` to true
helm install --generate-name https://github.com/arangodb/kube-arangodb/releases/download/1.4.4/kube-arangodb-1.4.4.tgz --set "operator.features.storage=true"

Enterprise Edition

# The following will install the operator and basic CRDs resources.
helm install --generate-name https://github.com/arangodb/kube-arangodb/releases/download/1.4.4/kube-arangodb-enterprise-1.4.4.tgz
# To use `ArangoLocalStorage`, set field `operator.features.storage` to true
helm install --generate-name https://github.com/arangodb/kube-arangodb/releases/download/1.4.4/kube-arangodb-enterprise-1.4.4.tgz --set "operator.features.storage=true"

Supporting charts

Besides the operator chart, the repository ships the platform-storage chart, which deploys an in-cluster S3-compatible object store (MinIO) and, optionally, an ArangoPlatformStorage backed by it. See docs/helm.md for the full list.

Upgrading the operator using Helm

To upgrade the operator to the latest version with Helm, you have to run helm upgrade with the --install flag to enable CRD installation.

NAME                      	NAMESPACE	REVISION	UPDATED                                 	STATUS  	CHART               	APP VERSION
kube-arangodb-1-1696919877	default  	1       	2023-10-10 08:37:57.884783199 +0200 CEST	deployed	kube-arangodb-1.2.31

So here, you would have to do

helm upgrade --install kube-arangodb-1-1696919877 https://github.com/arangodb/kube-arangodb/releases/download/1.4.4/kube-arangodb-1.4.4.tgz

Community Edition

# The following will install the operator and basic CRDs resources.
helm upgrade --install <NAME> https://github.com/arangodb/kube-arangodb/releases/download/1.4.4/kube-arangodb-1.4.4.tgz
# To use `ArangoLocalStorage`, set field `operator.features.storage` to true
helm upgrade --install <NAME> https://github.com/arangodb/kube-arangodb/releases/download/1.4.4/kube-arangodb-1.4.4.tgz --set "operator.features.storage=true"

Enterprise Edition

# The following will install the operator and basic CRDs resources.
helm upgrade --install <NAME> https://github.com/arangodb/kube-arangodb/releases/download/1.4.4/kube-arangodb-enterprise-1.4.4.tgz
# To use `ArangoLocalStorage`, set field `operator.features.storage` to true
helm upgrade --install <NAME> https://github.com/arangodb/kube-arangodb/releases/download/1.4.4/kube-arangodb-enterprise-1.4.4.tgz --set "operator.features.storage=true"

Building

DOCKERNAMESPACE=<your dockerhub account> make
kubectl apply -f manifests/arango-deployment-dev.yaml
# To use `ArangoLocalStorage`, also run
kubectl apply -f manifests/arango-storage-dev.yaml