Skip to content

Commit

Permalink
Using MM app and plugin with a custom server - moved to the custom se…
Browse files Browse the repository at this point in the history
…rver section (#544)
  • Loading branch information
alex-cit authored Jan 27, 2025
1 parent a5e04fd commit 2f45e3b
Show file tree
Hide file tree
Showing 15 changed files with 10 additions and 14 deletions.
1 change: 1 addition & 0 deletions REDIRECTS
Original file line number Diff line number Diff line change
Expand Up @@ -174,6 +174,7 @@ https://merginmaps.com/docs/layer/settingup_forms/ https://merginmaps.com/docs/l
https://merginmaps.com/docs/layer/settingup_forms_photo/ https://merginmaps.com/docs/layer/photos/
https://merginmaps.com/docs/layer/settingup_forms_settings/ https://merginmaps.com/docs/layer/form-configuration/
https://merginmaps.com/docs/manage/data_sync/ https://merginmaps.com/docs/manage/plugin/
https://merginmaps.com/docs/manage/plugin-multi-server-use/ https://merginmaps.com/docs/server/plugin-mobile-app/
https://merginmaps.com/docs/manage/plugin-sync-project/ https://merginmaps.com/docs/manage/plugin/
https://merginmaps.com/docs/misc/privacy/ N/A -- handled by https://merginmaps.com/privacy-policy/
https://merginmaps.com/docs/reference/licensing/ https://merginmaps.com/docs/misc/licensing/
Expand Down
4 changes: 2 additions & 2 deletions src/.vuepress/sidebar/en.js
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,6 @@ module.exports = {
'/manage/delete-files/',
'/manage/deploy-new-project/',
'/manage/missing-data/',
'/manage/plugin-multi-server-use/',
'/manage/plugin/',
'/manage/dashboard/',
'/manage/dashboard-maps/',
Expand Down Expand Up @@ -127,7 +126,8 @@ module.exports = {
'/server/install/',
'/server/upgrade/',
'/server/administer/',
'/server/troubleshoot/'
'/server/troubleshoot/',
'/server/plugin-mobile-app/'
]
},
{
Expand Down
2 changes: 1 addition & 1 deletion src/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,6 @@ The ecosystem consist of various components:
- [How to Delete Files](./manage/delete-files)
- [How to Deploy Revised Projects](./manage/deploy-new-project/)
- [How to Recover Missing Data](./manage/missing-data/)
- [How to <MainPlatformName /> with a Custom Server](./manage/plugin-multi-server-use/)
- [<QGISPluginName /> Overview](./manage/plugin/)
- [Home Page and Dashboard](./manage/dashboard/)
- [Maps in Dashboard](./manage/dashboard-maps/)
Expand Down Expand Up @@ -108,6 +107,7 @@ The ecosystem consist of various components:
- [Upgrade](./server/upgrade/)
- [Administer](./server/administer/)
- [Troubleshoot Custom Servers](./server/troubleshoot/)
- [Using Mergin Maps Mobile App and QGIS Plugin with a Custom Server](./server/plugin-mobile-app/)

## Migrate
- [From QField](./migrate/qfield/)
Expand Down
4 changes: 2 additions & 2 deletions src/manage/plugin/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ The toolbar contains following buttons:
- the <MainPlatformName /> logo is a shortcut to <AppDomainNameLink />
![A link to the Mergin Maps dashboard](./plugin-toolbar-logo.jpg "A link to the Mergin Maps dashboard")

- **Configure <MainPlatformName /> plugin** to [configure plugin](../../setup/install-mergin-maps-plugin-for-qgis/#plugin-configuration) to connect to <MainPlatformName /> or [a custom server](../plugin-multi-server-use/)
- **Configure <MainPlatformName /> plugin** to [configure plugin](../../setup/install-mergin-maps-plugin-for-qgis/#plugin-configuration) to connect to <MainPlatformName /> or [a custom server](../../server/plugin-mobile-app/)
![Configure Mergin Maps Plugin](../../setup/install-mergin-maps-plugin-for-qgis/qgis-configure-mergin-plugin.jpg "Configure Mergin Maps Plugin")
![](./plugin-configure.jpg "")

Expand Down Expand Up @@ -139,6 +139,6 @@ Local changes of a specific layer can also be extracted using the **Extract loca
## Mergin Maps in QGIS Plugins menu bar
**Plugins** menu bar in QGIS contains also <MainPlatformName /> options:
- **<MainPlatformName />** is a shortcut to <AppDomainNameLink />
- **Configure <MainPlatformName /> plugin** can be used to [configure plugin](../../setup/install-mergin-maps-plugin-for-qgis/#plugin-configuration) to connect to <MainPlatformName /> or [a custom server](../plugin-multi-server-use/)
- **Configure <MainPlatformName /> plugin** can be used to [configure plugin](../../setup/install-mergin-maps-plugin-for-qgis/#plugin-configuration) to connect to <MainPlatformName /> or [a custom server](../../server/plugin-mobile-app/)
- **Configure DB sync** can help you generate a initial configuration file for [DB sync](../../dev/dbsync/)
![Mergin Maps in QGIS Plugins menu bar](./plugins-menu-bar.jpg "Mergin Maps in QGIS Plugins menu bar")
Original file line number Diff line number Diff line change
@@ -1,15 +1,10 @@
# How to Use Mergin Maps with a Custom Server
# Using Mergin Maps Mobile App and QGIS Plugin with a Custom Server
[[toc]]

There is a default server <AppDomainNameLink /> which is configured in <QGISPluginName /> and in the <MobileAppNameShort />. However, you might want to use some custom server, e.g. when using [<MainPlatformName /> Community Edition](../../server/) or [<MainPlatformName /> Enterprise Edition](../../server/).
There is a default server <AppDomainNameLink /> which is configured in <QGISPluginName /> and in the <MobileAppNameShort />. However, you might want to use some custom server, e.g. when using [<MainPlatformName /> Community Edition](../index.md) or [<MainPlatformName /> Enterprise Edition](../index.md).

To do this, we need to set up the custom server in the [plugin](#custom-server-configuration-in-mergin-maps-qgis-plugin) as well as in the [mobile app](#custom-server-configuration-in-mergin-maps-mobile-app).

:::tip
The <MainPlatformName /> Community and Enterprise editions are private hosting solutions for those who would like to run their own deployment of <MainPlatformNameLink />.

See the [overview and pricing](https://merginmaps.com/pricing-for-ce-and-ee) for more details.
:::

## Custom server configuration in Mergin Maps QGIS plugin
To configure a custom <MainPlatformName /> server in the <QGISPluginNameShort />:
Expand All @@ -32,7 +27,7 @@ You might have started working on one server (e.g. staging server, official clou

### Using multiple servers simultaneously

If you need to handle two different servers at the same time, you will first need to create two user profiles in QGIS and download <QGISPluginName /> for both.
If you need to handle two different servers at the same time, you will first need to create two user profiles in QGIS and download the <QGISPluginNameShort /> for both.

![QGIS new profile](./new_profile.jpg "Create new profile in QGIS")

Expand All @@ -56,4 +51,4 @@ To configure a custom <MainPlatformName /> server in <MobileAppName />:
3. Use the username and password that is associated with this server and **Sign in**.
![Custom server in Mergin Maps mobile app](./mobile-app-custom-server-log-in.jpg "Custom server in Mergin Maps mobile app")

Now you are all set to use <MobileAppName /> with the custom server!
Now you are all set to use the <MobileAppNameShort /> with the custom server!

0 comments on commit 2f45e3b

Please sign in to comment.