Skip to content

update warning about not using cloud storage #794

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
alex-cit wants to merge 2 commits into
base: main
Choose a base branch
from
Open

update warning about not using cloud storage #794

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
87d429d
update warning about not using cloud storage
alex-cit Aug 10, 2026
9bc0945
rephrase warning
alex-cit Aug 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions src/manage/create-project/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -43,9 +43,11 @@ To work with <MainPlatformName /> projects in QGIS, you will need to [install th
Keep in mind that the project name cannot be changed later.
![New Mergin Maps project name and folder](./mergin_plugin_project_wizard_4.jpg "New Mergin Maps project name and folder")

:::danger WARNING
Your project should be saved on a local drive. Using shared network drives and cloud storage (such as OneDrive or Google Drive) is **not supported**.
:::
:::warning Network drives are not supported
When choosing where to save your <MainPlatformName /> project on your computer, a **local drive** is the best option.

Using shared network drives is **not supported**.
:::

The new <MainPlatformName /> project will be created locally on your computer and also on the <MainPlatformNameLink /> server.

Expand Down
8 changes: 5 additions & 3 deletions src/manage/plugin/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -69,9 +69,11 @@ Detailed steps on how to download and open your <MainPlatformNameLink /> project

2. Browse to the folder, where you want to save the project and click **Select folder**. The project will be downloaded here.

:::danger WARNING
Do not use shared network drives or cloud storage (such as OneDrive or Google Drive) to store your <MainPlatformName /> projects. It is not supported and can cause errors.
:::
:::warning Network drives are not supported
When choosing where to save your <MainPlatformName /> project on your computer, a **local drive** is the best option.

Using shared network drives is **not supported**.
:::

3. Once the download is completed, you will have the option to open the project in QGIS.

Expand Down
21 changes: 15 additions & 6 deletions src/manage/project/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,15 @@ What is a <MainPlatformName /> project?

It is basically a folder that contains data (such as vector layers, tables, rasters or photos), a [QGIS project](../../gis/features/), and some extra <MainPlatformName /> files needed to ensure everything works.

When <MainPlatformName /> project is created, it is saved to <ServerCloudNameLink />. From the cloud, it can be downloaded to various devices, used by different team members in both QGIS and the <MobileAppNameShort />. Changes they made are tracked and synchronised back to the cloud.
After the <MainPlatformName /> project is created, it is synchronised to <ServerCloudNameLink />. From the cloud, it can be downloaded to various devices, used by different team members in both QGIS and the <MobileAppNameShort />. Changes they made are tracked and synchronised back to the cloud.

When working with the project on a computer, we recommend storing it on a local drive. **Network drives are not recommended** as they can cause synchronisation issues.

::: details Limitations of network storage
If using a local drive is not an option and you have to use a network drive, make sure that it is used only by **one** person (not shared).

Network drives can cause [synchronisation](../synchronisation) issues due to [technical limitations](https://sqlite.org/useovernet.html) of GeoPackage (SQLite).
:::

## Creating project
:::tip
Expand Down Expand Up @@ -46,14 +54,15 @@ There are three options for handling layers:
Some layers are protected with some kind of authorisation, such as an API key or a token. The <QGISPluginNameShort /> packages <NoSpellcheck id="auth" /> DB entries used in layers in the `qgis_cfg.xml` file, so that these layers can be displayed in the <MobileAppNameShort />.
:::


After the layers for the new project are selected, you just need to enter the project's name and choose where to save it on your computer. It will also be saved on the <MainPlatformNameLink /> server in the selected workspace.

![New Mergin Maps project name and folder](../create-project/mergin_plugin_project_wizard_4.jpg "New Mergin Maps project name and folder")

:::danger WARNING
Your project should be saved on a local drive. Using shared network drives and cloud storage (such as OneDrive or Google Drive) is **not supported**.
:::

:::warning Network drives are not supported
When choosing where to save your <MainPlatformName /> project on your computer, a **local drive** is the best option.

Using shared network drives is **not supported**.
:::

### Mergin Maps project folder
The project folder on your computer will contain the **QGIS project** and all layers that were selected to be **packaged**. These are the files that are referenced in the project - and only they will be updated when the project is synchronised! The original data can be archived as they will not be used or needed by <MainPlatformName /> project anymore.
Expand Down
Loading