WeKan ® 
Home Status Docs Install Upgrade SaaS App Sponsors Awards Success FLOSS Developers Only Private Paid Commercial Support Sponsor Privacy Policy Blog

Upgrade


Platform Rating Version Details
Snap Newest
sudo snap list 		Already newest.
Automatic updates.
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
Docker, Kubernetes, OpenShift

.zip Bundle Windows/Linux/Mac		 Newest If installing now, newest available.

Bitnami MongoDB Docker images do not exist anymore. MongoDump/MongoRestore to groundhog2k MongoDB images

Manual 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.
Sandstorm Newest Newest WeKan available

1. Backup Sandstorm

2. Upgrade Sandstorm WeKan

Sandstorm Tempest Not available yet Tempest is still In Development.

It will be tried how to run Tempest, and see what it would require to have WeKan at Tempest
UCS Old Wait for new WeKan version.

New WeKan version development In Progress right now.
Friend Old Friend development continues at Kin. Current version is Kin-Legacy, and version in development is Kin-2. When it will be available, it will be tried what would it require to have WeKan at Kin-2.
ToroDB Old ToroDB is not developed anymore.

To replace MongoDB, instead use FerretDB/PostgreSQL.

Versions of WeKan


Above with 5 stars are maintained versions of WeKan. Others are currently being added or paused.

Registered trademark in Finland. Other countries usually honor trademarks of one country. Hall of Shame of fake non-WeKan companies.

WeKan is MIT License (MIT)