Skip to content

Latest commit

 

History

History
49 lines (39 loc) · 3.88 KB

README.md

File metadata and controls

49 lines (39 loc) · 3.88 KB
Raw

This chart installs the Mailu mail system on kubernetes

Prerequisites

  • a working HTTP/HTTPS ingress controller such as nginx or traefik
  • cert-manager v0.12 or higher installed and configured (including a working cert issuer).
  • A node which has a public reachable IP address because mail service binds directly to the node's IP
    • alternatively, inbound traffic routing for mail must be setup externally

Installation

  • Add the repository via helm repo add mailu https://mailu.github.io/helm-charts/
  • create a local values file (see below)
  • run helm install --values my-values-file.yaml mailu/mailu

Persistent Volume

This chart uses a hostPath persistence per default, and sets corresponding new PV and PVC automatically. You can override this behaviour by providing your own PV/PVC using the existingClaim persistence type per default. By default, it uses the chart name as the default app name, unless specified with the fullnameOverride parameter (truncated after 63 characters).

When leaving the default persistence type (hostPath), it will create and use a PV/PVC named like so: app_name-storage (e.g. mailu-storage).

Configuration

Parameter Description Default
mailuVersion Version/tag of mailu images master
logLevel Level of logging WARNING
nameOverride Override the resource name prefix mailu
fullnameOverride Override the full resource names mailu-{release-name} (or mailu if release-name is mailu)
hostnames List of hostnames to generate certificates and ingresses for not set
domain Mail domain name, see https://github.com/Mailu/Mailu/blob/master/docs/faq.rst#what-is-the-difference-between-domain-and-hostnames not set
passwordScheme Scheme used to hash passwords PBKDF2
secretKey Session encryption key for admin and webmail not set
mail.messageSizeLimitInMegabytes Message size limit in Megabytes 50
mail.authRatelimit Rate limit for authentication requests 10/minute;1000/hour
initialAccount.username Local part (part after @) for initial admin account not set
initialAccount.domain Domain part (part before @) for initial admin account not set
initialAccount.password Password for initial admin account not set
certmanager.issuerType Issuer type for cert manager ClusterIssuer
certmanager.issuerName Name of a preconfigured cert issuer letsencrypt
persistence.size requested PVC size 100Gi
persistence.type type of persistence (hostPath or existingClaim) hostPath
persistence.hostPath path of the hostPath persistence not set
persistence.storageClass storageClass to use for persistence (unused for persistence type existingClaim) not set
persistence.existingClaim existing PVC (mutually exclusive with hostPath, mandatory for existingClaim persistence type) not set

... TBD