Releases: MerginMaps/server
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.
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 #2653
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 2023.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
Contributors
Assets 2
2024.2.1 (Enterprise Edition)
This release introduces updates specifically designed for Mergin Maps Enterprise Edition users.
Redesign of dashboard
We are excited to announce the release of a redesigned version of our dashboard in Enterprise Edition. Redesign includes following changes:
- New dashboard visual
- Project members (Collaborators), workspace members, and invitations are now consolidated into a single, unified list.
- Project and workspace sharing has been simplified to a one-step process.
Other improvements and fixes
- Keeping selected objects in database (Workspace, User, Project, ProjectAccessRequest, WorkspaceInvitation and ProjectTransferRequests)
- Prevent database inconsistencies in project versions
- Show last seen workspaces in header switcher
- Improved permissions handling in project collaborators tab
Migration to this version
For detailed instructions on migrating from version 2023.6.1 to 2024.2.1, please refer to the documentation available here.
2023.6.1
Overview
API changes
- New endpoint for scheduled project removal
POST /v2/projects/{id}/scheduleDelete
DELETE /v1/project/{namespace}/{project name}marked as deprecated - New endpoint to remove project immediately (aka. hard delete)
DELETE /v2/projects/{id} - New endpoint for project rename
PATCH /v2/projects/<project_id>
Fixes
- Optimize db queries to prevent hammering db performance down for file download
Other
- Migrate web app to use Vue 2.7, Pinia and Vite libs
DB migrations
- community@3a77058a2fd7
Changelog
- Username to failed syncs by @luxusko in #109
- Delete project by id by @luxusko in #111
- Adjust delete project functionality by @luxusko in #114
- Add new api proxy by @varmar05 in #113
- Added /v2 api endpoint for scheduling delete project by @MarcelGeo in #117
- Update defaults to version 2023.3.0 by @MarcelGeo in #118
- Cleanup legacy dependencies by @MarcelGeo in #119
- Pinia with vue2 by @lavor in #92
- Update node version to 17 in dockerfile by @MarcelGeo in #120
- Minus from cookie parsing by @MarcelGeo in #121
- Add endpoint to rename a project by @harminius in #124
- Fix project download by @varmar05 in #127
- Rename Mergin to server by @PeterPetrik in #129
- 422 HTTP response is valid response and should not mess error logs by @harminius in #134
- Change PWD to "." in docker-compose.yml by @alhirzel in #132
- Prepare 2023.6.1 release + env var adjustments by @tomasMizera in #144
New Contributors
Full Changelog: 2023.3.0...2023.6.1
Contributors
Assets 2
2023.3.0
Community Edition
Features:
- API: Endpoint to get version details
- Complete removal of account so the email can be reused
- Add pagination to several objects (mostly in admin)
- New custom error codes responses
- Drop sending unnecessary notification emails
UI/UX fixes:
- Opening history version in a new tab fails
- Trailing whitespace issues in various forms / endpoints
- Days to complete project removal after deletion counted improperly
Sync issues fixes:
- Error in reconstruction of gpkg
- Do not allow upload of zero size gpkg
- Missing base file when getting a history version in webapp
Other fixes:
- Projects marked for removal should not be counted into workspace usage
- Users can't load projects list when a project does not have creator anymore
Enterprise Edition
All from CE.
Fixes:
- An expired invitation can't be deleted
- Direct sharing of projects through API does not add guests
- Warn users that workspace name can't be changed once created
- Fix search for workspace in admin interface
2023.2.0
- Rebranding to Mergin Maps
- Introduction of global workspace (permission rework)
- Infrastructure change: Split web-app and backend into separate applications (docker containers)
- Sync performance improvements
- Admin:
- rework removal-restoring of projects
- possibility to create user
- Lot of various fixes (UI/UX, API)
Migration guide from older release:
https://merginmaps.com/docs/dev/ce-migration/#migration-guide-to-2023-2
