Logo
Logo

Kubernetes

Deploy GenesisDB on Kubernetes as a single replica StatefulSet with a persistent volume.

Apply the following manifest and replace <your-auth-token> with a token of at least 32 bytes (openssl rand -hex 32).

GenesisDB is a single node database. Run the StatefulSet with `replicas: 1`: one process owns one data directory.
yaml
apiVersion: v1
kind: Secret
metadata:
  name: genesisdb
stringData:
  GENESISDB_AUTH_TOKEN: "<your-auth-token>"
---
apiVersion: v1
kind: Service
metadata:
  name: genesisdb
  labels:
    app: genesisdb
spec:
  type: ClusterIP
  selector:
    app: genesisdb
    tier: frontend
  ports:
    - name: http
      port: 8080
      targetPort: 8080
status:
  loadBalancer: {}
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: genesisdb-pv-claim
  labels:
    app: genesisdb
spec:
  accessModes:
    - ReadWriteOnce
  storageClassName: balanced-rwo
  resources:
    requests:
      storage: 500Mi
---
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: genesisdb
  namespace: default
spec:
  serviceName: genesisdb
  replicas: 1
  selector:
    matchLabels:
      app: genesisdb
  template:
    metadata:
      labels:
        app: genesisdb
        tier: frontend
    spec:
      securityContext:
        runAsUser: 10001
        runAsGroup: 10001
        fsGroup: 10001
        fsGroupChangePolicy: OnRootMismatch
      containers:
      - name: genesisdb
        image: genesisdb/genesisdb:latest
        imagePullPolicy: Always
        ports:
        - containerPort: 8080
        env:
        - name: GENESISDB_AUTH_TOKEN
          valueFrom:
            secretKeyRef:
              key: GENESISDB_AUTH_TOKEN
              name: genesisdb
        - name: GENESISDB_TZ
          value: "Europe/Vienna"
        - name: GENESISDB_PORT
          value: "8080"
        - name: GENESISDB_METRICS
          value: "true"
        volumeMounts:
        - name: genesisdb-data
          mountPath: /app/data
        resources:
          requests:
            memory: "128Mi"
            cpu: "100m"
      volumes:
      - name: genesisdb-data
        persistentVolumeClaim:
          claimName: genesisdb-pv-claim

The container runs as the unprivileged user and group 10001. fsGroup gives that group ownership of the persistent volume, so GenesisDB can write its data directory. fsGroupChangePolicy: OnRootMismatch only changes ownership when it does not match, which keeps restarts fast on large volumes.

The container image binds to 0.0.0.0, so the Service reaches it without further configuration. Put TLS in front with your ingress controller. Every environment variable is listed in Configuration.