kubedb · souravbiswassanto · May 25, 2026 · Apr 30, 2026 · May 1, 2026 · May 5, 2026
diff --git a/docs/examples/neo4j/quickstart/neo4j.yaml b/docs/examples/neo4j/quickstart/neo4j.yaml
@@ -0,0 +1,16 @@
+apiVersion: kubedb.com/v1alpha2
+kind: Neo4j
+metadata:
+  name: neo4j-test
+  namespace: demo
+spec:
+  replicas: 3
+  deletionPolicy: WipeOut
+  version: "2025.11.2"
+  storage:
+    storageClassName: local-path
+    accessModes:
+      - ReadWriteOnce
+    resources:
+      requests:
+        storage: 2Gi
diff --git a/docs/examples/neo4j/reconfigure-tls/ops-request.yaml b/docs/examples/neo4j/reconfigure-tls/ops-request.yaml
@@ -0,0 +1,13 @@
+apiVersion: ops.kubedb.com/v1alpha1
+kind: Neo4jOpsRequest
+metadata:
+  name: neo4j-reconfigure-tls
+  namespace: demo
+spec:
+  type: ReconfigureTLS
+  databaseRef:
+    name: tls-neo4j
+  tls:
+    rotateCertificates: true
+    bolt:
+      mode: mTLS
diff --git a/docs/examples/neo4j/reconfigure/ops-request.yaml b/docs/examples/neo4j/reconfigure/ops-request.yaml
@@ -0,0 +1,17 @@
+apiVersion: ops.kubedb.com/v1alpha1
+kind: Neo4jOpsRequest
+metadata:
+  name: neo4j-reconfigure
+  namespace: demo
+spec:
+  type: Reconfigure
+  databaseRef:
+    name: neo4j-test
+  configuration:
+    configSecret:
+      name: new-custom-config
+    removeCustomConfig: true
+    applyConfig:
+      server.metrics.csv.interval: "40s"
+  timeout: 5m
+  apply: IfReady
diff --git a/docs/examples/neo4j/restart/ops-request.yaml b/docs/examples/neo4j/restart/ops-request.yaml
@@ -0,0 +1,11 @@
+apiVersion: ops.kubedb.com/v1alpha1
+kind: Neo4jOpsRequest
+metadata:
+  name: neo4j-restart
+  namespace: demo
+spec:
+  type: Restart
+  databaseRef:
+    name: neo4j-test
+  timeout: 5m
+  apply: Always
diff --git a/docs/examples/neo4j/rotate-auth/ops-request.yaml b/docs/examples/neo4j/rotate-auth/ops-request.yaml
@@ -0,0 +1,11 @@
+apiVersion: ops.kubedb.com/v1alpha1
+kind: Neo4jOpsRequest
+metadata:
+  name: neo4j-rotate-auth
+  namespace: demo
+spec:
+  type: RotateAuth
+  databaseRef:
+    name: neo4j-test
+  timeout: 5m
+  apply: IfReady
diff --git a/docs/examples/neo4j/scaling/horizontal-scaling/ops-request.yaml b/docs/examples/neo4j/scaling/horizontal-scaling/ops-request.yaml
@@ -0,0 +1,14 @@
+apiVersion: ops.kubedb.com/v1alpha1
+kind: Neo4jOpsRequest
+metadata:
+  name: neo4j-horizontal-scale
+  namespace: demo
+spec:
+  type: HorizontalScaling
+  databaseRef:
+    name: neo4j-test
+  horizontalScaling:
+    server: 5
+    reallocate:
+      strategy: "incremental"
+      batchSize: 1
diff --git a/docs/examples/neo4j/scaling/vertical-scaling/ops-request.yaml b/docs/examples/neo4j/scaling/vertical-scaling/ops-request.yaml
@@ -0,0 +1,18 @@
+apiVersion: ops.kubedb.com/v1alpha1
+kind: Neo4jOpsRequest
+metadata:
+  name: neo4j-vertical-scale
+  namespace: demo
+spec:
+  type: VerticalScaling
+  databaseRef:
+    name: neo4j-test
+  verticalScaling:
+    server:
+      resources:
+        limits:
+          cpu: 1500m
+          memory: 4Gi
+        requests:
+          cpu: 700m
+          memory: 4Gi
diff --git a/docs/examples/neo4j/update-version/ops-request.yaml b/docs/examples/neo4j/update-version/ops-request.yaml
@@ -0,0 +1,11 @@
+apiVersion: ops.kubedb.com/v1alpha1
+kind: Neo4jOpsRequest
+metadata:
+  name: neo4j-update-version
+  namespace: demo
+spec:
+  type: UpdateVersion
+  databaseRef:
+    name: neo4j-test
+  updateVersion:
+    targetVersion: "2025.12.1"
diff --git a/docs/examples/neo4j/volume-expansion/ops-request.yaml b/docs/examples/neo4j/volume-expansion/ops-request.yaml
@@ -0,0 +1,12 @@
+apiVersion: ops.kubedb.com/v1alpha1
+kind: Neo4jOpsRequest
+metadata:
+  name: neo4j-volume-expand
+  namespace: demo
+spec:
+  type: VolumeExpansion
+  databaseRef:
+    name: neo4j-test
+  volumeExpansion:
+    mode: "Online"
+    server: 4Gi
diff --git a/docs/guides/neo4j/README.md b/docs/guides/neo4j/README.md
@@ -0,0 +1,93 @@
+---
+title: Neo4j
+menu:
+  docs_{{ .version }}:
+    identifier: neo4j-readme
+    name: Neo4j
+    parent: neo4j-guides
+    weight: 10
+menu_name: docs_{{ .version }}
+section_menu_id: guides
+url: /docs/{{ .version }}/guides/neo4j/
+aliases:
+  - /docs/{{ .version }}/guides/neo4j/README/
+---
+
+> New to KubeDB? Please start [here](/docs/README.md).
+
+# Overview
+
+KubeDB supports graph database deployment with Neo4j using the `Neo4j` CRD.
+
+## Supported Neo4j Features
+
+| Features                         | Availability |
+|----------------------------------|:------------:|
+| Standalone provisioning          |   &#10003;   |
+| Cluster provisioning             |   &#10003;   |
+| Monitoring                       |   &#10003;   |
+| TLS                              |   &#10003;   |
+| Ops Requests                     |   &#10003;   |
+
+## Supported Ops Requests
+
+- Reconfigure
+- HorizontalScaling
+- VerticalScaling
+- VolumeExpansion
+- UpdateVersion
+- ReconfigureTLS
+- RotateAuth
+- Restart
+
+## Example Neo4j Manifest
+
+```yaml
+apiVersion: kubedb.com/v1alpha2
+kind: Neo4j
+metadata:
+  name: neo4j-test
+  namespace: demo
+spec:
+  replicas: 3
+  deletionPolicy: WipeOut
+  version: "2025.12.1"
+  storage:
+    storageClassName: local-path
+    accessModes:
+      - ReadWriteOnce
+    resources:
+      requests:
+        storage: 2Gi
+```
+
+## User Guide
+
+- [Quickstart Neo4j](/docs/guides/neo4j/quickstart/quickstart.md) with KubeDB operator.
+- [Neo4j CRD Concept](/docs/guides/neo4j/concepts/neo4j.md).
+- [Neo4jVersion CRD Concept](/docs/guides/neo4j/concepts/catalog.md).
+- [Neo4jOpsRequest CRD Concept](/docs/guides/neo4j/concepts/opsrequest.md).
+- [Private Registry](/docs/guides/neo4j/private-registry/using-private-registry.md)
+- [Custom RBAC](/docs/guides/neo4j/custom-rbac/using-custom-rbac.md)
+- [Custom Configuration](/docs/guides/neo4j/configuration/using-config-file.md)
+- [Monitoring](/docs/guides/neo4j/monitoring/overview.md) for metrics collection guidance.
+- [Builtin Prometheus Monitoring](/docs/guides/neo4j/monitoring/using-builtin-prometheus.md)
+- [Prometheus Operator Monitoring](/docs/guides/neo4j/monitoring/using-prometheus-operator.md)
+- [TLS](/docs/guides/neo4j/tls/overview.md) for protocol-level TLS guidance.
+- [Configure TLS](/docs/guides/neo4j/tls/configure/)
+- [Ops Request](/docs/guides/neo4j/ops-request/overview.md) for supported operational changes.
+- [Reconfigure](/docs/guides/neo4j/reconfigure/overview.md)
+- [Reconfigure Details](/docs/guides/neo4j/reconfigure/reconfigure.md)
+- [Reconfigure TLS](/docs/guides/neo4j/reconfigure-tls/overview.md)
+- [Reconfigure TLS Details](/docs/guides/neo4j/reconfigure-tls/reconfigure-tls.md)
+- [Restart](/docs/guides/neo4j/restart/restart.md)
+- [Rotate Auth](/docs/guides/neo4j/rotate-auth/overview.md)
+- [Rotate Auth Details](/docs/guides/neo4j/rotate-auth/rotateauth.md)
+- [Update Version](/docs/guides/neo4j/update-version/overview.md)
+- [Update Version Details](/docs/guides/neo4j/update-version/versionupgrading/)
+- [Volume Expansion](/docs/guides/neo4j/volume-expansion/overview.md)
+- [Volume Expansion Details](/docs/guides/neo4j/volume-expansion/volume-expansion.md)
+- [Horizontal Scaling](/docs/guides/neo4j/scaling/horizontal-scaling/overview.md)
+- [Horizontal Scaling Details](/docs/guides/neo4j/scaling/horizontal-scaling/scale-horizontally/)
+- [Vertical Scaling](/docs/guides/neo4j/scaling/vertical-scaling/overview.md)
+- [Vertical Scaling Details](/docs/guides/neo4j/scaling/vertical-scaling/scale-vertically/)
diff --git a/docs/guides/neo4j/_index.md b/docs/guides/neo4j/_index.md
@@ -0,0 +1,10 @@
+---
+title: Neo4j
+menu:
+  docs_{{ .version }}:
+    identifier: neo4j-guides
+    name: Neo4j
+    parent: guides
+    weight: 16
+menu_name: docs_{{ .version }}
+---
diff --git a/docs/guides/neo4j/concepts/_index.md b/docs/guides/neo4j/concepts/_index.md
@@ -0,0 +1,10 @@
+---
+title: Neo4j Concepts
+menu:
+  docs_{{ .version }}:
+    identifier: neo4j-concepts
+    name: Concepts
+    parent: neo4j-guides
+    weight: 15
+menu_name: docs_{{ .version }}
+---
diff --git a/docs/guides/neo4j/concepts/catalog.md b/docs/guides/neo4j/concepts/catalog.md
@@ -0,0 +1,48 @@
+---
+title: Neo4jVersion CRD
+menu:
+  docs_{{ .version }}:
+    identifier: neo4j-catalog-concepts
+    name: Neo4jVersion
+    parent: neo4j-concepts-neo4j
+    weight: 15
+menu_name: docs_{{ .version }}
+section_menu_id: guides
+---
+
+> New to KubeDB? Please start [here](/docs/README.md).
+
+# Neo4jVersion
+
+## What is Neo4jVersion
+
+`Neo4jVersion` is the catalog CRD that provides image and version metadata for KubeDB-managed Neo4j.
+
+The value of `Neo4j.spec.version` must correspond to a valid `Neo4jVersion` resource.
+
+## Neo4jVersion Specification
+
+```yaml
+apiVersion: catalog.kubedb.com/v1alpha1
+kind: Neo4jVersion
+metadata:
+  name: 2025.11.2
+spec:
+  db:
+    image: docker.io/library/neo4j:2025.11.2-enterprise
+  securityContext:
+    runAsUser: 7474
+  version: 2025.11.2-enterprise
+```
+
+## Key fields
+
+- `metadata.name` is used in `Neo4j.spec.version`.
+- `spec.version` identifies the Neo4j release represented.
+- `spec.db.image` defines the image for Neo4j pods.
+- `spec.deprecated` signals if the version should be avoided.
+
+## Next Steps
+
+- Read the [Neo4j CRD concept](/docs/guides/neo4j/concepts/neo4j.md).
+- Run the [Neo4j quickstart](/docs/guides/neo4j/quickstart/quickstart.md).
diff --git a/docs/guides/neo4j/concepts/neo4j.md b/docs/guides/neo4j/concepts/neo4j.md
@@ -0,0 +1,66 @@
+---
+title: Neo4j CRD
+menu:
+  docs_{{ .version }}:
+    identifier: neo4j-concepts-neo4j
+    name: Neo4j
+    parent: neo4j-concepts
+    weight: 10
+menu_name: docs_{{ .version }}
+section_menu_id: guides
+---
+
+> New to KubeDB? Please start [here](/docs/README.md).
+
+# Neo4j
+
+## What is Neo4j
+
+`Neo4j` is a KubeDB CRD that provides declarative management for Neo4j graph databases in Kubernetes.
+
+## Neo4j Spec
+
+```yaml
+apiVersion: kubedb.com/v1alpha2
+kind: Neo4j
+metadata:
+  name: neo4j-test
+  namespace: demo
+spec:
+  replicas: 3
+  deletionPolicy: WipeOut
+  storageType: "Durable"
+  version: "2025.11.2"
+  configuration:
+    secretName: neo4j-custom-config
+  monitor:
+    agent: prometheus.io/operator
+    prometheus:
+      serviceMonitor:
+        labels:
+          release: prometheus
+        interval: 10s
+  tls:
+    issuerRef:
+      apiGroup: "cert-manager.io"
+      kind: Issuer
+      name: neo4j-ca-issuer
+  storage:
+    storageClassName: local-path
+    accessModes:
+      - ReadWriteOnce
+    resources:
+      requests:
+        storage: 2Gi
+```
+
+### Key fields
+
+- `spec.version` selects the `Neo4jVersion` to run.
+- `spec.replicas` sets the number of Neo4j instances in the cluster.
+- `spec.deletionPolicy` defines what KubeDB does with database resources when the `Neo4j` object is deleted.
+- `spec.storageType` specifies the persistence mode. With `Durable`, you should provide `spec.storage`.
+- `spec.storage` defines the persistent volume claim settings, such as `storageClassName`, `accessModes`, and requested storage size.
+- `spec.configuration.secretName` references a Secret containing a custom `neo4j.conf`.
+- `spec.monitor` enables monitoring integration. In this example, KubeDB creates a `ServiceMonitor` for Prometheus Operator.
+- `spec.tls.issuerRef` tells KubeDB which cert-manager issuer to use for generating Neo4j TLS certificates.