Releases: MerginMaps/server
2025.7.3 (Enterprise Edition)
Features
Allowing Inviting Users using the API
We introduced new endpoint for creating invitation for an external user using their email. The new endpoint is:
POST /v2/workspaces/{id}/invitations
Other fixes and enhancements
- Enhanced dashboard web maps synchronization stability
- Stability enhancements for downloading zip files from the dashboard
- Added last_signed_in attribute to the workspace members API response (/v2/workspaces/{id}/members). This attribute indicates the date when the user last logged in to Mergin Maps.
- Redesign sidebar with members detail in the workspace members tab
Migration to this version
This release requires a database migration. The following migrations have been created:
- community@b9ec9ab6694f
- enterprise@c40e5e645b57
For detailed instructions on migrating from version 2025.5.x to 2025.7.3, please refer to the documentation available here.
2025.7.3 (Community Edition)
Features
Download project enhancements
We have enhanced project downloading from the dashboard. The maximum size limit for projects or project versions available for download from the dashboard is now 10GB (previously ~1GB).
Other fixes and enhancements
- Support for storing diagnostic logs (from mobile application and QGIS plugin) on the custom server
- Enhancements for sub folders in dashboard project files
- Added folder permissions check to
server checkcommand - Added page titles for dashboard pages
Migration to this version
For detailed instructions on migrating from version 2025.2.2 to 2025.7.3, please refer to the documentation available here.
2025.5.1 (Enterprise Edition)
The 2025.5.1 patch addresses token expiration for Single Sign-On users within the Mergin Maps mobile application and QGIS plugin.
Migration to this version
If you are already on versions older than 2025.5.0, follow the migration guide for major release for details (https://github.com/MerginMaps/server/releases/tag/2025.5.0).
2025.5.0 (Enterprise Edition)
Single Sign-On Support
Using Single Sign-On is now available in the Enterprise Edition dashboard. Connect your Identity Provider to Mergin Maps and let your team sign in using their organisation credentials—no need to create separate accounts.
Use this guide to install services needed to handle Single Sign-On in Mergin Maps server.
Other features
Download project enhancements
We have enhanced project downloading from the dashboard. The maximum size limit for projects or project versions available for download from the dashboard is now 10GB (previously ~1GB).
Other fixes and enhancements
- Support for storing diagnostic logs on the server (Mergin Maps mobile application and QGIS plugin will implement this feature in upcoming releases)
- Fixed links to invitations in HTTPS deployments
- Allow contributors management in the dashboard workspace members table and sidebar
- Added page titles for dashboard pages
Migration to this version
This release requires a database migration. The following migrations have been created:
- community@6cb54659c1de
- enterprise@e95d051969ce
For detailed instructions on migrating from version 2025.3.0 to 2025.5.0, please refer to the documentation available here.
2025.3.0 (Enterprise Edition)
Features
Webmaps
Maps are now available for our Enterprise Edition users. Look for the "Map" tab in your project details. It displays your QGIS project layers over a basemap.
Remove user names from registration
We are introducing automatically generated usernames for new users. Users can still log in using their username or email.
Other fixes and enhancements
- Allow creation of workspace from admin panel
- 🛡️ Add mime types restrictions for uploaded files
- Enhancements for sub folders in dashboard project files
- Add folder permissions check to
server checkcommand
Migration to this version
This release requires a database migration. The following migrations have been created:
- community@5ad13be6f7ef
- enterprise@819e6b20ee93
For detailed instructions on migrating from version 2025.2.0 to 2025.3.0, please refer to the documentation available here.
2025.2.2 (Community Edition)
Features
Redesign of admin panel
We redesigned the admin panel to match the Mergin Maps dashboard design. The new 'Overview' page provides a summary of your server at /admin. Super admins can now switch between admin panel and dashboard using the footer link.
Database initialisation command
For fresh deployments, initialize the database using this command:
docker exec -it merginmaps-server flask initThis command will create database tables and add super admin user. For more details see documentation.
Improvements of sending emails
Empty default values for MAIL_USERNAME and MAIL_PASSWORD now enable email sending from SMTP servers without authentication. You can now use command for sending check email to your email:
docker exec -it merginmaps-server flask server send_check_email --email {YOUR EMAIL}
To check your deployment you can use new command:
docker exec -it merginmaps-server flask server check
Follow troubleshooting guide if you are having issues with sending emails.
Other enhancements and fixes
- Security vulnerabilities resolved regarding the uploading of malicious file paths to the server.
- Security vulnerabilities resolved regarding tokens generated for email and password resets.
- Mime types restrictions for push new files
- Enhancements for Gevent
- Upgrade to python 3.10
- Decrease size of database by removing JSONB data for project changes
- Add device_id column to login history and project versions table
- Enhance the speed of the project versions list
- Generate username automatically in "Create user" form
- Allow export server statistics from admin panel
Migration to this version
For detailed instructions on migrating from version 2024.2.2 to 2025.2.2, please refer to the documentation available here.
Environment variables
The following mandatory variables have been added (we recommend using strong, randomly generated strings for these values):
SECURITY_EMAIL_SALT- This salt is used for generating verification email tokens and should be a strong, randomly generated string.SECURITY_BEARER_SALT- This salt is used for decoding bearer tokens and should be a strong, randomly generated string.
The following environment variables have been added:
ENABLE_SUPERADMIN_ASSIGNMENT- The default value is True. If set to False, you will not be able to assign the super-admin role to a user from the admin panel.
The following environment variables were changed or deprecated:
RUN_CELERY- In the new docker-compose.yml file, the Celery beat and worker containers are separate. You no longer need to set this variable if you are using this version of Mergin Maps Server.USE_X_ACCEL- The default value is now True.
Full Changelog: 2024.2.2...2025.2.2
2025.2.0 (Enterprise Edition)
Features
Redesign of admin panel
We redesigned the admin panel to match the Mergin Maps dashboard design. The new 'Overview' page provides a summary of your server at /admin. Super admins can now switch between admin panel and dashboard using the footer link.
Remove username from registration
By this release are usernames gene
Workspace limits introduced for storage and contributors
Administrators now have the ability to configure workspace limits through the admin panel. This includes setting specific storage and contributor quotas for individual workspaces. Once these limits are established, users will be prevented from exceeding them within their respective workspaces.
Allowing export of server statistics
In the admin panel you can now export statistics for your deployment. Try it on /admin/settings address in advanced section.
Database initialisation command
For fresh deployments, initialize the database using this command:
docker exec -it merginmaps-server flask initThis command will create database tables and add super admin user. For more details see documentation.
Improvements of sending emails
Empty default values for MAIL_USERNAME and MAIL_PASSWORD now enable email sending from SMTP servers without authentication. You can now use command for sending check email to your email:
docker exec -it merginmaps-server flask server send_check_email --email {YOUR EMAIL}
To check your deployment you can use new command:
docker exec -it merginmaps-server flask server check
Follow troubleshooting guide if you are having issues with sending emails.
Other enhancements and fixes
- Security vulnerabilities resolved regarding the uploading of malicious file paths to the server.
- Security vulnerabilities resolved regarding tokens generated for email and password resets.
- Multiple fixes for switching workspaces in the dashboard
- Enhance the speed of the project versions list
- Reduce the size of the database with large project version changesets
- Fix missing invitation expiration in collaborators
- Disable case-sensitive handling of invitations emails
- Enhancements for Gevent
- Upgrade to python 3.10
Migration to this version
This release requires a database migration. The following migrations have been created:
- community@c13819c566e7
- community@57d0de13ce4a
- community@1ab5b02ce532
- community@1c23e3be03a3
- enterprise@f3fdcffa1031
- enterprise@6bee967ad61b
- community@d02961c7416c
- community@ba5051218de4
- enterprse@ba5ae5972c4a
For detailed instructions on migrating from version 2024.4.0 to 2025.2.0, please refer to the documentation available here.
Note: You need to have CREATE EXTENSION permission enabled for database user.
Environment variables
The following mandatory variables have been added (we recommend using strong, randomly generated strings for these values):
SECURITY_EMAIL_SALT- This salt is used for generating verification email tokens and should be a strong, randomly generated string.SECURITY_BEARER_SALT- This salt is used for decoding bearer tokens and should be a strong, randomly generated string.
The following environment variables have been added:
ENABLE_SUPERADMIN_ASSIGNMENT- The default value is True. If set to False, you will not be able to assign the super-admin role to a user from the admin panel.
The following environment variables were changed or deprecated:
WORKSPACE_INVITATION_EXPIRATION- The default value is now 14 days.RUN_CELERY- In the new docker-compose.yml file, the Celery beat and worker containers are separate. You no longer need to set this variable if you are using this version of Mergin Maps Server.USE_X_ACCEL- The default value is now True.
2024.4.0 (Enterprise Edition)
Features
Editor permission
This release introduces Editor role to workspaces and projects. Editors have more limited set of functionalities compared to the "Writer" role. The following editors rules are implemented to mergin server:
- modifying (add/remove/update) qgs and mergin-config file is not allowed
- removing geopackages file is not allowed
- updating the schema of geopackages is not allowed
Editor is available to collect features in mobile app or QGIS. On the other hand, in dashboard is editor considered as reader.
Other enhancements and fixes
- Case sensitive emails while log in
- Add ability to extend invitation with another project by sharing
- Fix invitations for existing guests
- Hide count of collaborators in projects tables
Migration to this version
For detailed instructions on migrating from version 2023.3.0 to 2024.4.0, please refer to the documentation available here.
2024.3.0 (Enterprise Edition)
Fixes
Improved Invitation Handling for Disabled User-Self-Registration
This release addresses an issue with the invitation workflow in Enterprise Edition deployments where self-registration is disabled (controlled by the USER_SELF_REGISTRATION environment variable). This update introduces the ability to register users directly through the invitation process, even if self-registration is disabled.
Other enhancements and fixes
- Store device id from mobile application to db tables: login_history and project_version #223
- Fix missing members - Handle Invitations for Non-Existent Projects
Migration to this version
For detailed instructions on migrating from version 2023.2.1 to 2024.3.0, please refer to the documentation available here.
2024.2.2 (Community edition)
Redesign of dashboard
We are excited to announce the release of a redesigned version of our dashboard in Community Edition. Redesign includes following changes:
- New dashboard visual
- Project collaborators tab
- Project sharing has been simplified to a one-step process
This release marks a significant update for Mergin Maps with the migration of our dashboard (@mergin/app package) and core library (@mergin/lib package) to Vue 3. We've chosen to adopt PrimeVue (https://github.com/primefaces/primevue) as our primary frontend framework.
For further details on the pull requests involved in this update, please refer this pull request #191.
Other enhancements and fixes:
- Handle logic for GLOBAL_READ, GLOBAL_WRITE and GLOBAL_ADMIN variables in collaborators tab #199 and #210
- Fixed broken paths in .prod.env #202
- Fixed database inconsistency in project versions in #180
- Keeping selected objects in database (users, projects and access requests) #184
Migration to this version
For detailed instructions on migrating from version 2023.6.1 to 2024.2.2, please refer to the documentation available here.
All pull requests
- Add build number to config by @harminius in #137
- Add build hash variable by @harminius in #152
- fix python style by @harminius in #170
- migration and table definition by @harminius in #174
- Get /app/project/{project_id}/access by @luxusko in #178
- Build 2024.1.0 by @MarcelGeo in #176
- unique project version for a project by @harminius in #180
- Keep objects referenced in database by @varmar05 in #184
- ProjectRole comparator, member field in project access by @luxusko in #187
- Make sure project access requests are resolved by @varmar05 in #190
- Develop redesign by @MarcelGeo in #191
- Add project deleted signal by @varmar05 in #194
- Enhancements accross application by @MarcelGeo in #192
- fix trial expiration error message by @harminius in #195
- API FIX: Accept/decline access request - Use project roles for permission checks, not project access. by @MarcelGeo in #197
- Added success notification for sharing members by @MarcelGeo in #198
- Add MAIL_USE_SSL to Flask configuration by @uprel in #196
- Allow share project parameter and check GLOBAL_ variables by @MarcelGeo in #199
- Build 2024.2.0 Develop -> Master by @MarcelGeo in #182
- Bump version in files 2024.2.0 by @MarcelGeo in #206
- Laptop breakpoint #207
- Add proxy for storing last seen worksapce in local storage #208
- Update of axios and vite #209
- Collaborators management based on GLOBAL_ variables #210
- Fix: .prod.env variables LOCAL_PROJECTS,TEMP_DIR #212
- Bump version to 2024.2.1 #213
- Fixed hard coded disabled reader role #219
- Fix workspace anonymization CE #220
- Filter active users in collaborators #222
- Disable coveralls #226
- Bump version to 2024.2.2 #227
New Contributors
- @jozef-budac made their first contribution in #164
- @uprel made their first contribution in #196
Full Changelog: 2023.6.1...2024.2.2
