Updating WhatsMax

There are two ways to update: the one-click updater in the admin panel, or a manual CLI update. Both need a valid, activated license.

mysqldump -u whatsmax -p whatsmax | gzip > ~/backup-whatsmax-$(date +%F).sql.gz
cp /var/www/whatsmax/.env ~/backup-env-$(date +%F)

Option A — one-click updater (recommended)

1. Go to Admin → System → License.
2. If a new version is available, an Update available card appears with the changelog.
3. Click Apply update. The updater downloads the release, replaces the application files, and runs the necessary migration steps.
4. When it finishes, rebuild and restart from the CLI:

cd /var/www/whatsmax
npm install          # in case dependencies changed
npm run db:deploy    # apply any new database migrations
npm run build
pm2 restart ecosystem.config.cjs

Option B — manual CLI update

1. Download the latest ZIP from your purchase downloads page.
2. Extract it over the existing installation — your .env is not part of the ZIP and stays untouched:

cd /var/www
unzip -o whatsmax-vX.Y.Z.zip -d whatsmax

3. Rebuild and restart:

cd /var/www/whatsmax
npm install
npm run db:generate
npm run db:deploy
npm run build
pm2 restart ecosystem.config.cjs

Verify after updating

• The version shown in Admin → System → License matches the release you applied.
• Admin → System → Queue and Cron show healthy workers/heartbeats.
• Log in to a workspace, open the inbox, send a test message.

Rollback

If something breaks:

# restore code: re-extract the previous version ZIP, then
npm install && npm run build && pm2 restart ecosystem.config.cjs

# restore database if migrations were applied:
gunzip < ~/backup-whatsmax-YYYY-MM-DD.sql.gz | mysql -u whatsmax -p whatsmax