Repository navigation
hMailServer 6.2.3
Re-published on GitHub on 18 October 2026 from the GitLab release v6.2.3 of 2026-06-15. Each file below was checked against the SHA-256 that GitLab's package registry records for it before it was uploaded here.
Re-published on GitLab on 24 September 2026 from the GitHub release of 15 June 2026 (2026-06-15 04:20:35 UTC, the time of the tag; the release's own time was not saved). Issue, pull request and discussion numbers below are GitHub's.
hMailServer 6.2.3
This is the first server-focused release since 6.2.2 (which shipped Control Panel changes against an unchanged server). 6.2.3 bundles the accumulated server hardening and new capabilities that have landed on master since then. Every new behaviour is additive and default-off — an existing installation upgrades with no functional change until the new settings are turned on. The installer no longer ships the classic Administrator; the modern .NET 8 Control Panel is the sole bundled GUI (DBSetup, DBUpdater and the Data Directory Synchronizer are retained). The server builds clean (0 warnings, 0 errors) and the full regression suite is green.
Mail filtering — Sieve (RFC 5228) + ManageSieve (RFC 5804)
A complete, standards-based filtering subsystem alongside the existing proprietary rules engine.
- Sieve interpreter. RFC 5228 lexer + recursive-descent parser building a validated AST. Control flow (
if/elsif/else/stop), the core tests (true/false/not/allof/anyof/header/address/exists/sizewith:is/:contains/:matches, address parts:all/:localpart/:domain, and the default +i;octetcomparators), and the core actions (keep/fileinto/discard/redirectplus implicit keep). - Live during local delivery. Each recipient account's active script is evaluated as the message is delivered:
fileintoroutes into the named IMAP folder,discardsilently drops,redirectqueues a copy to another address (reusing the forwarding copy/loop-guard/SRS path), and the implicit keep delivers to INBOX. A no-script account has zero overhead; an unparseable script never breaks delivery (it is logged and falls through to keep). - Per-account script storage on disk under
{DataDirectory}\Sieve\{domain}\{localpart}\, surfaced through the COM API as theAccount.SieveScriptproperty (andUtilities.CheckSieveSyntax/Utilities.EvaluateSieveScript). - ManageSieve service (RFC 5804). An optional listener (enabled via
[Settings] ManageSieveServerPort, disabled by default) for managing multiple named scripts over TCP: CAPABILITY, SASL PLAIN AUTHENTICATE (against the regular account database), PUTSCRIPT/CHECKSCRIPT (syntax-checked), LISTSCRIPTS, GETSCRIPT, SETACTIVE, DELETESCRIPT, HAVESPACE, NOOP, LOGOUT, including non-synchronizing literals. Activating a script over ManageSieve is immediately honoured by local delivery. - Control Panel. The account dialog gained a Sieve editor tab, and the feature settings pages gained a ManageSieve card.
Operability & observability
Health & readiness probes (on the metrics listener)
Enabled via [Settings] MetricsServerPort, the unauthenticated listener now serves Kubernetes-style probes alongside /metrics:
/livez— 200 once the listener is up./readyz— 200 when the server is running and the DB pool is connected, else 503 (so load balancers stop routing during startup/shutdown)./healthz— JSON: status, server state, database up/down, per-protocol session counts, uptime.
Prometheus metrics on /metrics
- Database —
hmailserver_database_up(1/0) andhmailserver_db_connections{state="busy|available"}pool gauges. - Database query latency + slow-query log (new in 6.2.3). Every statement is timed at the single backend-agnostic chokepoint (so MySQL, PostgreSQL, MS SQL and SQL CE are covered uniformly): the summary
hmailserver_db_query_seconds(_sum+_count) gives average query latency without per-query histograms, andhmailserver_db_slow_queries_totalcounts slow statements. A new[Settings] SlowQueryLogMilliseconds(default 0 = log disabled, metrics still run) logs any statement at/over the threshold with every SQL string literal redacted to '?' so inlined secrets never reach the log. - TLS —
hmailserver_tls_handshakes_totalandhmailserver_tls_handshake_failures_total. - Delivery queue —
hmailserver_delivery_queue_messages(cached 10 s so frequent scrapes never issue aCOUNT(*)per request). - Authentication —
hmailserver_auth_success_total/hmailserver_auth_failures_total, incremented from the central logon path (every protocol) for credential-stuffing / brute-force alerting. - Delivery outcomes —
hmailserver_messages_delivered_total,hmailserver_messages_deferred_total,hmailserver_messages_bounced_total. - Command latency — the summary
hmailserver_command_processing_seconds(_sum+_count) across every SMTP/IMAP/POP3 command line.
Reliability & durability
- Connection-pool condition variable — the DB pool no longer busy-polls with
Sleep(10)while waiting for a free connection; it blocks on a condition variable signalled on release, removing scrape/latency jitter under pool exhaustion. - Graceful shutdown drain — on shutdown the server moves to a stopping state (so
/readyzreturns 503) and, if[Settings] ShutdownDrainSeconds > 0, waits up to that window for active sessions to finish before tearing down listeners. Default 0 preserves immediate stop. - Configurable message-store fsync — with
[Settings] MessageStoreFsync = 1a received message is forced to physical disk before the server acknowledges it to the sender. Default 0 keeps the previous OS-buffered behaviour. - Message-store consistency check + recovery report — opt-in via
[Settings] MessageStoreConsistencyCheck = 1: a scheduled, read-only task cross-checks every message row against its file on disk, publisheshmailserver_messagestore_missing_files, and writes a timestamped recovery report listing any affected messages. It never deletes or repairs anything. - Log retention —
[Settings] LogDeleteDays(default 0 = disabled) deletes hMailServer's own date-stamped log files older than the configured age. Onlyhmailserver_*.log/ERROR_hmailserver_*.logare ever touched.
Tracing
- Message-to-session correlation IDs — the Received header now carries an RFC 5321 id clause equal to the numeric TCP session id, and that same id prefixes every line of the session log, so a delivered message can be traced back to the exact session that received it with no external trace system.
High availability
- Active/passive runbook — a documented, validated topology (shared external database + shared message store + floating VIP) with readiness-gated, graceful-
drain failover, inhmailserver/docs/HighAvailabilityRunbook.md.
Deliverability & SMTP standards
- BATV (prvs) backscatter protection. Local outbound MAIL FROM is signed
prvs=<K><DDD><6-hex HMAC>=local@domain(wire-only; the envelope domain is preserved so SPF/DKIM stay aligned). Inbound bounces to a prvs return-path are HMAC/day-window validated and stripped back to the original recipient, while forged null-sender bounces to invalid tags are rejected. Default-off via[Settings] BATVEnabled/BATVSecret. - CHUNKING / BDAT (RFC 3030). EHLO advertises CHUNKING; message data may be submitted as one or more byte-counted
BDAT chunk-size [LAST]commands instead of a dot-terminated DATA stream. Chunk payloads are read verbatim (byte-transparent: no dot-unstuffing, no<CRLF>.<CRLF>terminator) and concatenated into one message; DATA after BDAT is rejected 503 and a non-numeric chunk-size 501. Implemented additively so the existing DATA path is untouched.
Supply chain & quality gates
- SBOM — a workflow emits SPDX + CycloneDX inventories (Syft) on every push to master and attaches them to each published release.
- Dependabot — CVE / security-advisory alerts and grouped weekly update PRs for the NuGet packages and GitHub Actions.
- Dependency-review PR gate — fails any PR that introduces a high/critical-CVE dependency.
New hMailServer.INI [Settings] keys (all backward compatible)
| Key | Default | Effect |
|---|---|---|
SlowQueryLogMilliseconds |
0 | Log (redacted) + count DB statements at/over this many ms (0 = log off, metrics still run). |
ManageSieveServerPort |
0 | Enable the ManageSieve (RFC 5804) listener. |
ShutdownDrainSeconds |
0 | Wait up to N seconds for active sessions to finish on shutdown. |
MessageStoreFsync |
0 | Force received messages to disk before acknowledging. |
MessageStoreConsistencyCheck |
0 | Enable the read-only store-vs-DB consistency scan + report. |
LogDeleteDays |
0 | Delete hMailServer's own logs older than N days. |
BATVEnabled / BATVSecret |
off | Enable BATV prvs backscatter protection. |
(The metrics listener itself remains controlled by the existing MetricsServerPort / MetricsServerBindAddress keys.)
The Control Panel requires the .NET 8 Desktop Runtime (bundled by the installer and installed silently when missing).
Assets
| File | Size | SHA-256 |
|---|---|---|
hMailServer-6.2.3-x64.exe |
82,783,362 | 6b6eb923a83e1adab8d7f1aabef7c1506027c87aa1ad7b80b052443380f6086f |
hmailserver.cyclonedx.json |
27,758 | 89b968da4c939ab0154fccace6ca57f379bd7d720f89f1e8332e332d3ef1bf1e |
hmailserver.spdx.json |
78,873 | 7c34b3d744baf5f9643d94c69856aaa176ed20fe2c6b787f13e6bb1499e73108 |
These are the files published with the GitHub release, byte for byte, re-hosted in this project's package registry. The hashes above were computed from them on 24 September 2026. The Windows installer of this release was not Authenticode-signed (Authenticode signing began with 6.3.1). GitHub made no signature for releases before 6.2.19, so there is no independent record of these bytes beyond this table.