Skip to content

Garrison 0.1.0

Choose a tag to compare

@relative23 relative23 released this 12 Nov 12:27
· 445 commits to main since this release

The first release of Garrison, a console for everything around a Stalwart
mail server that Stalwart's own WebUI leaves to you. It works with Stalwart
1.1.0.

What is in it

  • Pages for the dashboard, services, antivirus, the spam filter, attacks and
    bans, backups, DNS and TLS, alerts and maintenance, and for deliveries, SMTP
    sessions and the event history.
  • Checks of the host and of Stalwart that run every minute: units, pending
    security updates, a disk forecast, certificates of every listener, DNS
    records, blocklists, restic and borg repositories, test mail through the
    server.
  • Messages to an ntfy topic, a webhook or a mailbox when a check fails and
    when it is in order again.
  • An optional filter, off by default, that has Stalwart refuse or mark mail
    with Office macros.
  • An installer with backup and rollback, garrison setup for a first
    installation at a terminal, garrison doctor to check one, and an Ansible
    role.

The changelog
has the full list.

Installing

Garrison needs Linux on x86_64 or aarch64 with systemd 247 and polkit 0.106 or
newer, nginx or another TLS proxy, and Stalwart 1.1.0 on the same host. Take
the archive for your architecture and its .minisig, check the signature
with the key from the README, then follow the
quick start.

Each archive comes with its signature, its checksum and a CycloneDX SBOM.

Checking a download

Both archives were built twice by the release workflow and once on the
maintainer's machine, with byte-identical results, and GitHub's build
attestation names the commit they come from. Check the signature before you
unpack an archive:

minisign -Vm garrison-0.1.0-x86_64.tar.gz -P RWSKAjJdo0lsYJJA64rSgwP6KeVtTEbgqB12xkoAVxzQd+l9U0OplCP6

It must end with Trusted comment: garrison 0.1.0 x86_64 (or aarch64).

Archive SHA-256
garrison-0.1.0-x86_64.tar.gz ad461f2d878ff734e7da11049d194afbb7f1307ae6cbce2398065e754ebdf398
garrison-0.1.0-aarch64.tar.gz f6b54b4a48d78b4fda6ac1529f052341d026684427ccb5db085bff60f86be39b

Upgrades

garrison upgrade installs later releases once their signature checks out,
and garrison install --rollback returns to the one before. The changelog
names whatever an upgrade asks of you.