New to KubeDB? Please start here.

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.

Enterprise Edition: All KubeDB-managed Neo4j versions use the Neo4j Enterprise image. Verify your Neo4j license requirements before deploying in production.

Neo4jVersion Specification

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 the value you use in Neo4j.spec.version.
• spec.version is the full Neo4j version string (including edition suffix).
• spec.db.image is the container image used for Neo4j pods.
• spec.securityContext.runAsUser: 7474 — Neo4j runs as UID 7474 (the neo4j system user inside the official image).
• spec.deprecated: true marks a version that should no longer be used. KubeDB will warn you if you reference a deprecated version.

List available versions and check for deprecated ones

$ kubectl get neo4jversions
NAME        VERSION                DB_IMAGE                                       DEPRECATED   AGE
2025.10.1   2025.10.1-enterprise   docker.io/library/neo4j:2025.10.1-enterprise                12d
2025.11.2   2025.11.2-enterprise   docker.io/library/neo4j:2025.11.2-enterprise                12d
2025.12.1   2025.12.1-enterprise   docker.io/library/neo4j:2025.12.1-enterprise                12d

If the DEPRECATED column shows true for a version you are currently using, upgrade to a supported version via UpdateVersion.

Next Steps

• Read the Neo4j CRD concept.
• Run the Neo4j quickstart.