v3.2.0

Worklenz/worklenzv3.2.0Oct 8, 2026by chamikaJ

Upgrading?

AI Summary

This release focuses on self-hosted improvements, including the migration of object storage from MinIO to SeaweedFS and the addition of SMTP support for email notifications. It also includes updates to make upgrades more reliable and improves documentation.

Key Highlights

  • Enabled Planner, Finance, and Client Portal by default for self-hosted installations
  • Added SMTP support for email invitations and notifications
  • Migrated storage backend from MinIO to SeaweedFS (S3-compatible interface)
  • Startup validation now reports incomplete or invalid email configuration

Breaking Changes

  • Upgrading requires backing up PostgreSQL and migrating existing MinIO data to SeaweedFS
  • SMTP configuration is now required for self-hosted email invitations and notifications

New Features

  • SMTP support for email invitations and notifications
  • Configurable public hostname for Client Portal links
  • Startup validation for email configuration

Full Release Notes

## What’s Changed in v3.2.0

### Self-hosted improvements

- Planner, Finance, and Client Portal are now enabled by default for self-hosted installations.
- Added SMTP support for email invitations and notifications. Administrators can configure their own SMTP provider and sender address.
- Client Portal invitation and password-reset links can now use a configurable public hostname.
- Startup validation now reports incomplete or invalid email configuration. [[#520](https://github.com/Worklenz/worklenz/pull/520)](https://github.com/Worklenz/worklenz/pull/520)

### Storage and deployment

- Replaced the bundled MinIO-based object storage setup with SeaweedFS, using an S3-compatible interface. Existing MinIO data should be backed up and migrated before upgrading. [[#423](https://github.com/Worklenz/worklenz/pull/423)](https://github.com/Worklenz/worklenz/pull/423)
- Added missing baseline migrations and made existing migrations idempotent to make upgrades more reliable. [[#487](https://github.com/Worklenz/worklenz/pull/487)](https://github.com/Worklenz/worklenz/pull/487)
- Docker image references are pinned to `3.2.0`. [[#495](https://github.com/Worklenz/worklenz/pull/495)](https://github.com/Worklenz/worklenz/pull/495)

### Documentation

- Updated setup and deployment documentation.
- Added Planner and Import/Export to the documented feature set.
- Added self-hosted SMTP, Client Portal hostname, and manual deployment guidance. [[#453](https://github.com/Worklenz/worklenz/pull/453)](https://github.com/Worklenz/worklenz/pull/453), [[#485](https://github.com/Worklenz/worklenz/pull/485)](https://github.com/Worklenz/worklenz/pull/485)

### Maintenance

- Reduced optional AppSumo extension log noise.
- Updated backend, frontend, and client portal dependencies, including security and maintenance updates for packages such as `multer`, `sharp`, `DOMPurify`, `axios`, `morgan`, and `js-yaml`.

## Upgrade Notes

Before upgrading:

1. Back up your PostgreSQL database and existing object storage data.
2. If upgrading from MinIO, plan the migration of existing files to SeaweedFS.
3. Pull the v3.2.0 changes and rebuild/restart the applications.
4. For self-hosted email invitations, add SMTP configuration to `worklenz-backend/.env`:

```env
WORKLENZ_DEPLOYMENT_MODE=self_hosted

EMAIL_PROVIDER=smtp
EMAIL_FROM="Worklenz <noreply@your-domain.com>"
SMTP_HOST=smtp.your-provider.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=your-smtp-username
SMTP_PASSWORD=your-smtp-password

CLIENT_PORTAL_HOSTNAME=client.your-domain.com
```

For SMTP providers using implicit TLS, use port `465` with `SMTP_SECURE=true`.

**Full Changelog:** https://github.com/Worklenz/worklenz/compare/v3.1.0...v3.2.0

Related Repositories