v3.0.0 is a major release with a significant number of improvements and fixes.

What's new?

• The concurrent core or the "engine" is completely re-written. Campaign pausing and cancellations are now near-instant and lossless. Concurrent campaign sending performance has improved significantly. The sent count now accounts for every single message rather than an approximation.
• Major performance improvements for large databases with the new Settings -> Performance -> Cache slow queries option. On installations with millions of subscribers, enabling this speeds up database queries (retrieving lists, subscribers etc.) by several orders of magnitude. On a production database with ~14 million subscribers, the speed up on the lists page was 2000x, from ~20s to ~10ms.
• New frontend dependency and build system refactor, speeding the admin pages (and the development build process).
• Addressed the root cause of mysterious SMTP sending errors that triggered only in certain SMTP environments.
• New fields for filtering lists, campaigns, subscribers in query APIs.
• Campaign archives now support “slugs” (clean permalinks) for public URLs instead of UUIDs.
• Major refactor and cleanup of documentation.
• F9 shortcut key for campaign and template previews.
• Many quality-of-life improvements, fixes, and dependency upgrades.

How to upgrade

As always, take a backup of your database before upgrading.

Binary

Download the latest binary. Stop and replace the old binary. Run ./listmonk --upgrade. Start the app again.

Docker

# cd /directory/with/docker-compose.yml

docker-compose down
docker-compose pull && docker-compose run --rm app ./listmonk --upgrade
docker-compose up -d app db

Changelog

• f9120d9 Auto-translate one missing i18n key..
• 36e39e5 Auto-translate missing i18n scripts.
• 8939d27 Reformat sl i18n language file.
• 82894e5 Simplify default e-mail template.
• dc43e9c Configure Markdown parser to not escape double quotes. Closes #1698.
• 3103bbc feat: Add Slovenian localization (#1704)
• d70236c Fix incorrect error message in tx template preview.
• 2841586 Fix sorting in camapaign analytics view counts.
• 6cb9982 Add .IndividualTracking to public templates. Closes #1663.
• 74ef6f5 Add a 'view' link on the lists page. Closes #1674.
• 7c44eb0 Replace Go easyjson lib.
• f14df89 Update Go deps.
• f0a3cbd Remove redundant SMTP test error toast on the admin UI.
• 45f4ae1 Add performance/query caching docs.
• 9adc5e7 Refactor navigation and styling in docs.
• bb1492b Merge branch 'query-performance'
• 5a3664a Add support for caching slow queries on large databases.
• a5b06a8 fixed railway icon and spelling bug (#1696)
• 9e96649 Update schema.sql - change default bounce settings (#1669)
• 67bc2ce Improve SES bounce processing docs (#1676)
• 98fa3e0 Update templating.md with command to fetch templates from repo (#1677)
• e42ab9c Bump vite from 5.0.10 to 5.0.12 in /frontend (#1680)
• 0935e9c Bump follow-redirects from 1.15.3 to 1.15.4 in /frontend (#1664)
• 4c5df16 Add deploy template for RepoCloud.io (#1662)
• 2f487de Log subscriber id/uuid on failed opt-in message push. Closes #1333.
• 908173c Style the 'fix code' buttn on campaign archive tab.
• d8ca26e Add a 'template reference' docs link next to campaign editor. Closes #1405.
• 9109097 Remove incorrect API def from docs. Closes #1658.
• 7067f05 Update listmonk-simple.service - add optional log file (#1640)
• 8677151 Merge branch 'slug'
• 0d319ad Add 'slug' (permalink) support for campaign archives. Closes #1394.
• 78caa35 fix: add copying campaign object before sending test message (#1659)
• 3335171 Fix (accidentally) broken migration scripts.
• 3711bed Fix clipboard copy prop on template form.
• bd2990f Add F9 shortcut key for toggling campaign and template previews.
• 234fd11 Fix incorrect label on maintenance UI. Closes #1652.
• a93031d Make Makefile accept custom build versions from env for dev builds.
• fa2c840 Rename v2.6.0 migration to v3.0.0, the next major release.
• a6d55d6 Upgrade smtp-pool lib fixing bad conn state issues.
• 8add9d6 Merge branch 'fix-campaign-sent'
• 9a96134 Update installation.md +tut & minor changes (#1647)
• 772476c Add accurate sent count, last sent subscriber tracking on campaigns.
• 414c5c0 Refactor the core concurrent campaign manager logic.
• 0c9dc07 Add a ?v=hash cache breaker (that changes on restart) to static assets.
• a2629c2 Make all ID/UUID labels on the UI onclick -> clipboard copy.
• b946c33 Fix broken chart components.
• 2feb1b0 Make the name part in from e-mails optional. Closes #1602.
• b2a5e37 Fix incorrect form messages on public re-subscription to double opt-in lists. Closes #1638.
• bce6758 Fix preconfirm option not working on bulk 'select all' subscriber list management. Closes #1646.
• 0d74619 Make providing name in subscriber creation optional and assign internally. Closes #1630.
• a9a7156 Scroll TinyMCE richtext editor back to caret on dialog close. Closes #1635.
• db17fa1 Restore tab selection on campaign page on reload.
• 49bbf92 Merge branch 'upgrade-frontend'
• ef77a7e Replace c3js with chart.js for major dep size reduction.
• f4b2446 Update configuration.md +logs section (#1641)
• 9bd7511 Update italian translation (#1644)
• af8b420 Refactor and upgrade the frontend vue code to work with vite instead of webpack.
• 51af75c Add subscription status filter to subscriber list query and admin UI.
• 8f12c03 Fix newly created lists not showing up on other pages automatically. Closes #1589.
• 01acd38 Add tag/type/optin filter options to lists and campaigns APIs. Closes #1631.
• c468e7a Upgrade Cypress to latest version.
• 5d63574 Skip non-existent dirs in --static-dir mode to use default stuffed dirs. Closes #1599.
• aba7111 Fix default non-stuffed frontend dir path.
• dd87a10 Addte listmonk-simple.service (#1622)
• 6a26580 Update general-question.md
• 9a30067 Create da.json (Danish translation) (#1628)
• 80b2537 Bump golang.org/x/crypto from 0.15.0 to 0.17.0 (#1632)
• be62c50 feat: Add from_email to postback struct for sending tx postbacks (#1623)
• e869f7b Translate to Ukrainian (#1606)
• b6922b0 Suppress 'no campaign' errors on pixel view registration. Closes #1588.
• 95dabe5 Update upgrade.md +binary info (#1613)
• e06d379 Update installation.md +tutorials (#1611)
• 7c99167 Update installation.md +changing port (#1607)
• fa50664 Add i18n Greek translation (#1605)
• 53eb71a Add 404 HTTP handlers to prevent those requests going to BasicAuth endpoints.
• 2ce2a11 feat: docker compose use alpine for postgres (#1603)
• 52ee79b chore: noreferrer for listmonk url in footer (#1601)
• 524be27 Bump tinymce from 5.10.8 to 5.10.9 in /frontend (#1592)
• 75befe5 📝🐛 — Fix /api/subscribers/lists doc (#1594)
• 4577868 chore: remove refs to deprecated io/ioutil (#1593)
• c59825f Fix broken sorting (lists -> subcount, subscribers -> status) in queries. Closes #1076.
• 06b4494 Fix incorrect sanitisation of search queries on list/campaign frontend.
• 82c74cd Bump golang.org/x/image from 0.6.0 to 0.10.0 (#1580)
• 4c8c19e Update configuration.md - update path due to recent install path change (#1581)
• d439ecf Bump axios from 0.27.2 to 1.6.0 in /frontend (#1587)
• ef08495 Make the unsub form on opt-in confirmation e-mail open 'manage' by default. Closes #1515.
• 44d3462 Fix 'confirmed' subscriptions becoming 'unconfirmed' on public form re-signup. Closes #1441.
• 62be5e2 Fix mysteriously broken frontend build by switching eslint parser dep.
• 49ec11c Merge branch 'refactor-docs'
• e8ecdf8 Fix mkdocs links in docs.
• ff135ec Add 'copy code' button to code snippets in docs.
• be4be72 Refactor and clean up API Markdown docs.
• f8a55f8 Fix mkdocs navbar shadow
• 9e3af91 Update fr.json (#1586)
• f720e88 Refactor hr style in mkdocs template.
• b29f565 Fix broken table in campaign doc. Closes #1585.
• 3641f74 Add missing header field in campaign creation docs. Closes #1561.
• ccceaa6 Bump @babel/traverse from 7.21.3 to 7.23.2 in /frontend (#1563)
• c7882bb Bump tinymce from 5.10.7 to 5.10.8 in /frontend (#1564)
• fd05a6d Update installation.md - add cd listmonk (#1576)
• 06332d5 Update de.json (#1572)
• 1ebd80c Add Hebrew translation. Closes #1517.
• 491fab3 Update i18n language files.
• 764a052 Bump golang.org/x/net from 0.8.0 to 0.17.0 (#1555)
• c911aeb Fix attachments being omitted from postback (#1557)
• 954ed45 Fix incorrect Slovak language code. Closes #1533.
• a61a9d8 Fix preference management logic to avoid unnecessary DB calls.
• 99c71a2 fix: update inlang settings (#1529)
• 82c3c68 Clean root URL of trailing slashes when updating settings.
• 04e571d Fix file fetch in attachments failing for signed URLs. Closes #1499.
• 8f2a08b Fix invalid suffix 'd' in timestring string in s3 expiry config.
• 11f90b2 Fix typo in i18n S3 expiry description.
• 5af6252 Fix make not picking up semver from git archive builds. Fixes #1380.
• 717a636 Add Sprig and other tpl functions to static templates as well. Closes #1527.
• 7019f26 Fix docs for public subscription api (#1522)
• 9423c74 Docker Multi Arch (esp. ARM) builds: Improving Build File (#1451)
• 2b95c88 Add Postmark bounce webhook support (refactor #1385) (#1485)
• e5ac111 Update installation.md - fly.io instructions not working (#1487)
• 34d86fc Update installation.md (#1494)
• 5664e5c fix: replace docker-compose with docker compose (#1490)
• 83c88d7 Escape search query in list search. Closes #1471.
• 16eeb94 added "tutorials" section and other minor edits (#1444)
• e317f2c Modify sed flag based on OS. Closes #1474.
• 25513b8 go: bump to 1.20 (#1479)
• eefcbc3 Fix hardcoded DB name in 'about' SQL query. Closes #1477.
• 52a7298 Update bounces.md (#1468)
• 6af904d Lowercase email search on UI to match lowercase email index in DB. Closes #1464.
• 07a9632 Update latest version on homepage.
• 4b05ab1 Add check for SES 'invalid domain' transient bounces. Closes #1463.
• e2f1313 Update configuration.md (#1465)
• fcdea60 Update bounces.md (#1466)
• 2888dcd Update upgrade.md (#1467)