Chart version: 2.3.1
Api version: v1
App version: 1.0.0
DEPRECATED - An e-mail testing tool for developers
Chart Type
Set me up:
helm repo add center
Install Chart:
helm install mailhog center/stable/mailhog
Versions (0)


This chart has been deprecated and moved to its new home:

helm repo add codecentric

Mailhog is an e-mail testing tool for developers.


$ helm install stable/mailhog


This chart creates a Mailhog deployment on a Kubernetes cluster using the Helm package manager.


  • Kubernetes 1.5+ with Beta APIs enabled

Installing the Chart

To install the chart with the release name my-release:

$ helm install --name my-release stable/mailhog

The command deploys Mailhog on the Kubernetes cluster in the default configuration. The configuration section lists the parameters that can be configured during installation.

Uninstalling the Chart

To uninstall/delete the my-release deployment:

$ helm delete my-release

The command removes all the Kubernetes components associated with the chart and deletes the release.


The following table lists the configurable parameters of the Mailhog chart and their default values.

Parameter Description Default
image.repository container image repository mailhog/mailhog
image.tag container image tag v1.0.0
image.pullPolicy container image pull policy IfNotPresent
auth.enabled specifies whether basic authentication is enabled, see false
auth.existingSecret if auth is enabled, uses an existing secret with this name; otherwise a secret is created ""
auth.fileName the name of the auth file auth.txt
auth.fileContents the contents of the auth file ""
nodeSelector node labels for pod assignment {}
podAnnotations annotations to be added to pods {}
resources pod resource requests & limits {}
service.annotations annotations for the service {}
service.clusterIP internal cluster service IP ""
service.externalIPs service external IP addresses []
service.loadBalancerIP IP address to assign to load balancer (if supported) ""
service.loadBalancerSourceRanges list of IP CIDRs allowed access to load balancer (if supported) []
service.type type of service to create ClusterIP
service.node.http http port of service ""
service.node.smtp smtp port of service ""
service.nodePort.http if service.type is NodePort and this is non-empty, sets the http node port of the service ""
service.nodePort.smtp if service.type is NodePort and this is non-empty, sets the smtp node port of the service ""
ingress.enabled if true, an ingress is created false
ingress.annotations annotations for the ingress {}
ingress.path if true, an ingress is created /
ingress.hosts a list of ingress hosts []
ingress.tls a list of IngressTLS items []
env Mailhog environment variables, see {}

Specify each parameter using the --set key=value[,key=value] argument to helm install. For example,

$ helm install --name my-release \
  --set env.MH_UI_WEB_PATH=mailhog \

Alternatively, a YAML file that specifies the values for the parameters can be provided while installing the chart. For example,

$ helm install --name my-release -f values.yaml stable/mailhog


  • Disk storage not yet supported (env.MH_STORAGE: maildir)
  • The env property allows Mailhog to be freely configured via environment variables, but not all settings may work, e. g. changing ports using MH_SMTP_BIND_ADDR, MH_API_BIND_ADDR, or MH_UI_BIND_ADDR does not make sense with the standard Docker image because it would also require exposing different ports.