Kubernetes¶

A reference manifest for running StrataFS in Kubernetes. The image is the same one used for Docker deployments.

Quick deploy¶

A self-contained Deployment + Service + PersistentVolumeClaim:

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: stratafs-state
spec:
  accessModes: [ReadWriteOnce]
  resources:
    requests:
      storage: 20Gi
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: stratafs
spec:
  replicas: 1
  selector:
    matchLabels: { app: stratafs }
  strategy:
    type: Recreate          # single-writer SQLite
  template:
    metadata:
      labels: { app: stratafs }
    spec:
      containers:
      - name: stratafs
        image: ghcr.io/neul-labs/stratafs:latest
        ports:
        - containerPort: 8080
          name: rest
        - containerPort: 8081
          name: mcp
        env:
        - name: STRATAFS_WORKERS
          value: "4"
        readinessProbe:
          httpGet: { path: /health, port: rest }
          periodSeconds: 5
        livenessProbe:
          httpGet: { path: /health, port: rest }
          periodSeconds: 30
        resources:
          requests:
            cpu: "500m"
            memory: "512Mi"
          limits:
            cpu: "2"
            memory: "1.5Gi"
        volumeMounts:
        - { name: state, mountPath: /app/.stratafs }
        - { name: data,  mountPath: /app/data }
      volumes:
      - name: state
        persistentVolumeClaim:
          claimName: stratafs-state
      - name: data
        emptyDir: {}        # or your own PVC / hostPath
---
apiVersion: v1
kind: Service
metadata:
  name: stratafs
spec:
  selector: { app: stratafs }
  ports:
  - { name: rest, port: 8080, targetPort: rest }
  - { name: mcp,  port: 8081, targetPort: mcp  }

Apply:

kubectl apply -f stratafs.yaml
kubectl port-forward svc/stratafs 8080:8080 8081:8081

Helm¶

A first-party Helm chart is on the Roadmap but not yet published. Until then, the manifest above is the canonical reference — drop it into your own chart, Kustomize overlay, or GitOps repo.

Caveats¶

Single replica. Per-source SQLite is single-writer. Run StrataFS as a single pod and scale up the embedding worker pool with STRATAFS_WORKERS.
State is precious. The PVC at /app/.stratafs holds your index. Back it up with a VolumeSnapshot or external sidecar — losing it means reindexing from scratch.
Auth. StrataFS has no built-in auth. Front it with an ingress that does — see the Production Checklist.
Logging. StrataFS logs to stdout/stderr; collect with whatever you use for the rest of the cluster.