Repository navigation
Settings Overview
This page began as a chapter of the 6.2.10 manual and has been corrected for 6.2.24. The Control Panel's pages are grouped differently now, so the paths below use today's groups; the TLS ports 465, 993 and 995 exist only after you create them on the TCP/IP ports page (a fresh install seeds 25, 587, 110 and 143); and everything added since 6.2.10 is in Changes Since 6.2.10. Where a value here disagrees with the Settings Reference, which is generated from the code, the reference is right.
Everything here is also editable in the Control Panel, which offers to restart the
service when a change requires it. File: Bin\hMailServer.INI, section [Settings].
Values shown are the defaults.
MtaStsEnabled=1 ; honour recipient MTA-STS policies when sending
DaneEnforcementEnabled=1 ; honour recipient DANE/TLSA records when sending
DnssecValidationEnabled=1 ; validate DNSSEC for DANE and SPF/DKIM/DMARC lookups
DnssecTrustAnchors= ; override root trust anchors ("tag alg digesttype hex;...")
ArcSealingEnabled=0 ; add ARC seals when forwarding (uses the domain's DKIM key)
TlsRptFromAddress= ; sender for daily TLS-RPT reports (empty = disabled)
TlsRptOrganizationName=hMailServerAcmeEnabled=0 ; issue and renew certificates automatically
AcmeContactEmail= ; expiry notices from the CA
AcmeDomains= ; comma-separated host names for the certificate
AcmeDirectoryUrl=https://acme-v02.api.letsencrypt.org/directory
AcmeHttpPort=80 ; port for http-01 challenges
AcmeReuseKey=1 ; keep the same key across renewals (keeps TLSA records valid)WebServicesHttpPort=0 ; 80 to enable
WebServicesHttpsPort=0 ; 443 to enable (uses the ACME certificate if none is set)
WebServicesBindAddress=0.0.0.0
MtaStsHostingEnabled=1 ; serve https://mta-sts.<domain>/.well-known/mta-sts.txt
MtaStsPolicyMode=enforce ; enforce, testing or none
MtaStsPolicyMaxAge=604800
MtaStsPolicyMx= ; override mx patterns (default: the domain's live MX records)
AutoconfigEnabled=1 ; Thunderbird autoconfig + Outlook autodiscover
AutoconfigClientHost= ; host name clients connect to (default: the server's host name)Per domain, point mta-sts.<domain>, autoconfig.<domain> and autodiscover.<domain>
at this server, and include them in AcmeDomains for HTTPS.
RestApiPort=0 ; REST admin API (administrator password over HTTP Basic, or an API key as Bearer); after 6.2.27 also the self-service portal at /portal
RestApiBindAddress=127.0.0.1 ; TLS is required unless bound to 127.0.0.1, localhost or ::1
RestApiCertificateFile= ; PEM; falls back to the ACME certificate
RestApiPrivateKeyFile=
MetricsServerPort=0 ; Prometheus metrics endpoint (/metrics) + health probes
MetricsServerBindAddress=127.0.0.1
LogDeleteDays=0 ; prune date-stamped logs older than N days (0 = keep all)
ShutdownDrainSeconds=0 ; on stop, wait up to N seconds for sessions to finish
MessageStoreFsync=0 ; force each message to physical disk before acknowledging
MessageStoreConsistencyCheck=0; periodically cross-check message rows against files
ManageSieveServerPort=0 ; ManageSieve (RFC 5804); standard port 4190
ManageSieveServerBindAddress=127.0.0.1
JsonLogging=0 ; write logs as JSON linesUpdateCheckEnabled=0 ; read the project's release feed every UpdateCheckHours
UpdateCheckHours=24
UpdateChannel=stable ; or prerelease
UpdateFeedUrl= ; empty = this project's GitHub releases; set for a mirror
UpdateAutoDownload=0 ; fetch and Sigstore-verify the installer as soon as one is found
UpdateWindow= ; when a verified update may be applied unattended, e.g. Sun 03:00 (empty = never)
UpdateBackupBeforeApply=1 ; back up to the configured destination before an unattended apply
UpdateRequireAuthenticode=0 ; also require an Authenticode signature on the installer
UpdateServiceWaitSeconds=180 ; how long the helper waits for the service before rolling backThe trust settings (UpdateTrustRootsFile, UpdateLogPublicKeyFile, UpdateSigningIdentity,
UpdateSigningIssuer, UpdateSourceRepository) default to the public Sigstore instance and
this repository's release workflow; see the Settings Reference.
ProtectStoredSecretsWithDPAPI=1 ; machine-scoped DPAPI for reversible stored secrets
ServiceAccountName= ; run the service as this account (empty = LocalSystem)
ServiceAccountPassword= ; empty for virtual/managed accountsSRSEnabled=0 ; Sender Rewriting Scheme for forwarded mail
SRSSecret= ; HMAC secret for SRS (required when SRSEnabled=1)
MaxSubmissionsPerIPPerMinute=0 ; cap MAIL FROM per source IP per minute (0 = off)
MaxOutboundPerDestinationPerMinute=0 ; cap outbound per destination domain (0 = off)PIPELINING, SMTPUTF8/EAI (RFC 6531/6532), ENHANCEDSTATUSCODES (RFC 2034), DSN
(RFC 3461), CHUNKING/BDAT (RFC 3030) and 8BITMIME are advertised automatically and
need no configuration. Legacy HELO sessions keep the classic non-enhanced replies.
hMailServer 6.3.8, the latest release (2 November 2026, schema 6108) · AGPL-3.0-or-later · Repository · Mirror on GitHub · Report a documentation error (a GitLab issue naming the page)
Home — full index
Start here
1. Install and run
- Before You Install
- Installing hMailServer
- Installing on Linux
- Running in a Container
- Profiles and Environment
- The Control Panel
- The Control Deck
- Your First Domain and Mailbox
- Connecting a Mail Client
- The Webmail
- DNS for Your Domain
- Migration
2. Secure it
- Encryption and Certificates
- Database TLS
- Encryption for People
- Stopping Spam
- Stopping Viruses
- Security Hardening
- Secure Defaults
- The Service Account
- Secrets at Rest
- Sign-in and Identity
- Security Policy
3. Operate it
- Monitoring and Health
- The SNMP Agent
- Backup and Restore
- Message Storage
- Compliance and eDiscovery
- Troubleshooting
- Diagnosing Stalled Mail
- Relocating an Installation
- Upgrading hMailServer
- Upgrading Guide
- The Update Feed
- Migrating the Database Backend
- High Availability Runbook
- Warm Standby
- Runbooks Digest
4. Extend it
- Rules and Sieve
- Aliases Lists and Public Folders
- Rooms and Equipment
- Mailing Lists
- Routes and Relays
- Mail In to a Webhook
- Outbound Shaping
- The COM API and Scripting
- Event Scripts
- The REST API
- Command Line
- APIs Reference
5. Contribute to it
- Project Handbook
- Architecture
- Contributing
- Release Process
- Governance
- Assurance Case
- Regression Test Environment
- Fuzzing
- Regulatory Scope
- Third-Party Binaries
Look it up — from any journey
- Settings Reference
- Settings Overview
- Capabilities and Configuration
- Control Panel Reference
- Control Panel Pages
- Ports Reference
- Changes-Since-6210
- Version-History-to-6210
- Glossary
About this wiki
- hMailServer 6.3.8 is the latest release (2 November 2026, schema 6108)
- Pages say since 6.3.4 where a feature is new in it
- AGPL-3.0-or-later
- Repository, the one place the project is worked on
- Its mirror on GitHub, since 18 October 2026, with no Issues
- Questions: a GitLab issue with the Question template, GitHub Discussions Q&A, or the forum
- Report a documentation error: a GitLab issue naming the page