Rework upgrade. Address remarks for #586

Author: fernandinand

src/server/environment/index.md

@@ -116,7 +116,7 @@ Other settings related to data management.
 | `DELETED_PROJECT_EXPIRATION` | integer  | `7`                                   | Lifetime in days for deleted projects. Expired projects are removed permanently without possibility to restore afterwards.                                                                                |
 | `PROJECT_ACCESS_REQUEST`     | integer  | `604800`                              | Lifetime of active project access request in seconds.                                                                                                                                                     |
 | `TEMP_EXPIRATION`            | integer  | `7`                                   | Time in days after files in a temporary folder are permanently deleted.                                                                                                                                   |
-​
+
 
 #### Celery asynchronous tasks
 Mergin Maps is using Celery and Redis to perform asynchronous tasks or doing regular jobs.
@@ -129,11 +129,8 @@ Mergin Maps is using Celery and Redis to perform asynchronous tasks or doing reg
 #### WebMaps 
 <ServerType type="EE" />
 
-| Variable name            | Type     | Default                                                 | Description                    |
-|--------------------------|----------|---------------------------------------------------------|--------------------------------|
-| `MAPS_ENABLED`           | boolean  | `false`                                                 | Flag to enable webmaps         |
-| `OVERVIEW_DATA`          | string   | `/data/overviews`                                       | Folder to store overviews data |
-| `WMTS_SERVER_URL`        | string   | `http://mergin-qgis-nginx:80`                           | URL to qgis-server WMTS server |
-| `QGIS_EXTRACTOR_API_URL` | string   | `http://mergin-qgis-extractor:8000`                     | URL for QGIS Extractor service |
-| `VECTOR_TILES_URL`       | string   | `https://tiles.merginmaps.com`                          | URL to custom tile service     |
-| `VECTOR_TILES_STYLE_URL` | string   | `https://tiles.dev.merginmaps.com/styles/default.json`  | URL to custom tile style JSON  |
+| Variable name            | Type     | Default                       | Description                    |
+|--------------------------|----------|-------------------------------|--------------------------------|
+| `MAPS_ENABLED`           | boolean  | `false`                       | Flag to enable webmaps         |
+| `VECTOR_TILES_URL`       | string   | ``                            | URL to custom tile service     |
+| `VECTOR_TILES_STYLE_URL` | string   | ``                            | URL to custom tile style JSON  |

src/server/install/index.md

@@ -89,10 +89,10 @@ Now tweak deployment settings by modifying environment variables. You have to fi
 <ServerType type="EE" />
 
 WebMaps consists of three more services (`mergin-qgis`, `mergin-qgis-extractor` and `mergin-qgis-nginx`) that you can run alongside <MainPlatformName /> main stack or independently in a new machine. 
-Just make sure related `MAPS_*` [environment variables](../environment/#WebMaps) are set, namely `MAPS_ENABLED` (`True` by default).
+Just make sure `MAPS_ENABLED` [environment variable](../environment/) is set to `True` (`False` by default) and `VECTOR_TILES_URL` as well `VECTOR_TILES_STYLE_URL` are set correctly to your target tile service.
 For convenience this stack is provided on a separate docker compose file, `docker-compose.maps.yml`.
 
-To run the webmaps, simply run this command line:
+To run the webmaps stack, simply run this command line:
 ```shell
 $ docker-compose -f docker-compose.maps.yml -d up
 ```

src/server/upgrade/index.md

@@ -1,4 +1,4 @@
-git# Upgrade
+# Upgrade
 
 Migration guides are here to help you migrate your <CommunityPlatformNameLink /> or <EnterprisePlatformNameLink /> to the latest server version. The main Cloud <DashboardLink desc="Mergin Maps Server"/> is always migrated to latest version by <MainPlatformName /> team. Read more about server platforms in [overview article](../).
 
@@ -15,22 +15,35 @@ Make sure to always back up your database data before doing a migration.
 
 <MigrationType type="EE" />
 
+::: tip Changes on deployment behaviour
+Release 2025.3.x brings some changes on <MainPlatformName /> docker compose orchestration deployment procedure.
+Users are advised to clone the <GitHubRepo id="MerginMaps/server/blob/master/" desc="server repository" /> in order to proceed with the new deployment procedure.
+:::
+
 Get the latest <GitHubRepo id="MerginMaps/server/blob/master/docker-compose.yml" desc="docker-compose file" />  or update docker images manually to version `2025.3.0`.
 Perform the migration:
 
-1. Stop your running docker containers and build the new images
+1. Stop your running docker containers
    ```bash
-    $ docker compose -f docker-compose.yml down # or similarly, based on your deployment
+    $ docker compose -f docker-compose.yml down # or similarly, based on your previous deployment
     # INFO: After shutdown update the docker-compose.yml file to latest release
    ```
-
-2. Start up your docker containers   
+2. If you didn't clone the <MainPlatformName /> github repository, do it now and locate yourself under `deployment/enterprise` folder
+   ```bash
+    $ git clone git@github.com:MerginMaps/server.git # If you haven't cloned the repo yet
+    $ cd server/deployment/enterprise
+   ```
+3. If you plan to use the new webmaps stacks, adapt your existing `.prod.env` and `docker-compose.yml` files. Move/copy them to the `enterprise` deployment folder  
+   ```bash
+    $ cp /some/path/.prod.env . # assuming you are located in `server/deployment/enterprise`
+    $ cp /some/path/docker-compose.yml . # assuming you are located in `server/deployment/enterprise`
+   ```
+4. Start up your docker containers   
    ```bash
     $ docker compose -f docker-compose.yml -d up # or similarly, based on your deployment
-    $ docker compose -f docker-compose.maps.yml -d up # If you want to deploy maps stack
+    $ docker compose -f docker-compose.maps.yml -d up # If you want to deploy webmaps stack
    ```
-
-3. Check that you are on correct versions (`ba5051218de4`, `ba5ae5972c4a`).
+5. Check that you are on correct versions (`ba5051218de4`, `ba5ae5972c4a`).
     ```bash
     $ docker exec merginmaps-server flask db current
     INFO  [alembic.runtime.migration] Context impl PostgresqlImpl.
@@ -44,8 +57,7 @@ Perform the migration:
     $ docker exec merginmaps-server flask db stamp ba5051218de4
     $ docker exec merginmaps-server flask db stamp ba5ae5972c4a
     ```
-
-4. Run the database migration:
+6. Run the database migration:
     ```bash
     $ docker exec merginmaps-server flask db upgrade community@5ad13be6f7ef
     $ docker exec merginmaps-server flask db upgrade enterprise@819e6b20ee93