Skip to content

Docmost

Helm chart for deploying Docmost on Kubernetes with bundled PostgreSQL and Redis by default, persistent local storage for uploads, and optional S3-compatible object storage.

Key Features

  • Official Docmost image based on docmost/docmost
  • Bundled PostgreSQL default install includes the HelmForge PostgreSQL chart
  • Bundled Redis default install includes the HelmForge Redis chart
  • External services support managed PostgreSQL and Redis can be used instead of subcharts
  • Local or S3 storage choose persistent local storage or S3-compatible object storage for uploads
  • Ingress support configurable ingress with stable external URL handling
  • Bootstrap-ready database PostgreSQL init scripts grant Docmost the required extension privileges on first startup

Installation

HTTPS Repository

helm repo add helmforge https://repo.helmforge.dev
helm repo update
helm install docmost helmforge/docmost

OCI Registry

helm install docmost oci://ghcr.io/helmforgedev/helm/docmost

Basic Example

docmost:
  appUrl: https://docmost.example.com

ingress:
  enabled: true
  ingressClassName: traefik
  hosts:
    - host: docmost.example.com
      paths:
        - path: /
          pathType: Prefix

External Services with S3

database:
  mode: external
  external:
    host: postgres.example.internal
    existingSecret: docmost-db

postgresql:
  enabled: false

redis:
  enabled: false
  external:
    host: redis.example.internal
    existingSecret: docmost-redis

storage:
  mode: s3
  s3:
    bucket: docmost
    endpoint: https://minio.example.internal
    existingSecret: docmost-s3

Key Values

KeyDefaultDescription
replicaCount1Number of Docmost application pods
docmost.appUrl""External URL used by Docmost
database.modeautoDatabase mode: auto, external, or postgresql
postgresql.enabledtrueDeploy bundled PostgreSQL
redis.enabledtrueDeploy bundled Redis
storage.modelocalUploads storage mode: local or s3
storage.local.size10GiLocal uploads PVC size
storage.s3.bucket""S3 bucket name
ingress.enabledfalseEnable ingress exposure

Version Note

  • Docker Hub exposed 0.71.0, while the official GitHub releases page still showed v0.70.3 during chart creation
  • because HelmForge validates application releases against both sources, the chart currently pins 0.70.3

Operational Notes

  • this alpha chart currently supports replicaCount=1 only
  • default installs use bundled PostgreSQL and Redis
  • the PostgreSQL bootstrap enables unaccent and pg_trgm, which Docmost migrations require

More Information