Upgrade

Already newest.
Automatic updates.

If there are missing cards

Upgrade to 10.92 or newer. Then:

sudo snap refresh wekan

sudo snap stop wekan

sudo cp -a /var/snap/wekan/common /root/wekan-common-backup-$(date +%F)

sudo snap run wekan.database-compare

sudo snap run wekan.database-merge

sudo snap start wekan

Please Change to Stable

sudo snap refresh wekan --channel=latest/stable --amend

On first start after upgrading from old WeKan 6, it automatically migrates the MongoDB data and attachments/avatars to FerretDB (SQLite). Migration progress shows at the WeKan web address, and a migration interrupted by a snap refresh or reboot resumes where it left off. The original MongoDB data is never modified or deleted.

Watch migration and database logs:
sudo snap logs -f wekan.mongodb

Retry or force a fresh MongoDB → FerretDB migration:
sudo snap run wekan.migrate

Choose which database WeKan runs on (mongodb also pauses auto-migration, ferretdb switches to the migrated FerretDB):
sudo snap run wekan.database mongodb
sudo snap run wekan.database ferretdb

Maintenance page on/off: while on, users see an "under maintenance" page (HTTP 503), and you can start sudo snap start wekan.mongodb or sudo snap start wekan.ferretdb by hand to reach the data over the MongoDB wire protocol on port 27019 (one at a time, they share the port):
sudo snap run wekan.maintenance on
sudo snap run wekan.maintenance off

More upgrade info

General Upgrade Steps

With these steps, attachments and avatars are visible.

1. Production Setup, for 14k or more users: Docker amd64/arm64 where is METEOR_REACTIVITY_ORDER=oplog,polling with other settings mentioned at docker-compose.yml and Docs
2. For automatic updates, Snap Beta amd64/arm64, that may need sudo snap set wekan mongodb-port='27019'. Other settings similar like above Docker.
3. For Windows: METEOR_REACTIVITY_ORDER=polling and these Docker settings (NOT experimental changeStreams and NOT oplog) and others similar like above Docker.
4. (or MongoDB alternative, experimental FerretDB 2/PostgreSQL, see issue 6425)
5. mongodump MongoDB 3.x) or any other MongoDB version
6. mongorestore to MongoDB 7.x
7. If there is WRITABLE_PATH/ files attachments avatars, copy from /var/snap/wekan/common/files or /data/files to newest WeKan directory
8. Admin Panel/Attachments/Default Storage: Filesystem
9. Admin Panel/Attachments/Move Attachments from MongoDB CollectionFS to Filesystem
10. Admin Panel/Attachments/Move Attachments from MongoDB Meteor-Files to Filesystem
11. Admin Panel/Attachments/MongoDB GridFS Storage/Compact MongoDB database, to make it use less disk space.

• Tempest Blog post
• Tempest Forum
• Tempest Repo