Skip to content

Commit 55989bd

Browse files
committed
Mark variables which should be changed for production use
1 parent 0ff43fd commit 55989bd

File tree

1 file changed

+20
-20
lines changed

1 file changed

+20
-20
lines changed

src/dev/mergince.md

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -64,14 +64,14 @@ Mergin Maps uses PostgreSQL database to store its data.
6464
| Variable name | Type | Default | Description |
6565
|---------------------------|-----------|-----------|-------------|
6666
| `DB_APPLICATION_NAME` | string | `mergin` | Comment in database connection string to better identify connection source. |
67-
| `DB_DATABASE` | string |`postgres` | Database to store <MainPlatformName /> tables. |
67+
| `DB_DATABASE` ⭐️ | string |`postgres` | Database to store <MainPlatformName /> tables. |
6868
| `DB_HOST` | string | `db` | Database host. Mapped to docker-compose service name. |
69-
| `DB_PASSWORD` | string |`postgres` | PostgreSQL user password. |
69+
| `DB_PASSWORD` ⭐️ | string |`postgres` | PostgreSQL user password. |
7070
| `DB_PORT` | integer | `5432` | Database port. If non-default should match port exposed in docker-compose file. |
7171
| `DB_POOL_MAX_OVERFLOW=10` | integer | `10` | Database `max_overflow` limit for [SQLAlchemy](https://docs.sqlalchemy.org/en/14/core/engines.html). |
7272
| `DB_POOL_SIZE` | integer | `2` | Database pool size for SQLAlchemy. With overflow determines maximum of concurrent connections to database. |
7373
| `DB_POOL_TIMEOUT` | integer | `300` | Database pool timeout for SQLAlchemy. |
74-
| `DB_USER` | string |`postgres` | PostgreSQL user to connect to <MainPlatformName /> database. |
74+
| `DB_USER` ⭐️ | string |`postgres` | PostgreSQL user to connect to <MainPlatformName /> database. |
7575
7676
#### Permission management
7777
To ease the process of permission (user) management, you can set the following global variables that apply to all registered users.
@@ -101,23 +101,23 @@ To ease the process of permission (user) management, you can set the following g
101101
#### Data synchronisation and management
102102
Other settings related to data management.
103103

104-
| Variable name | Type | Default | Description |
105-
|---------------------------|---------|-------------|---------------------------|
106-
| `GLOBAL_WORKSPACE` | string | `mergin` | Namespace (part of URL) for all projects. All projects belong to this single workspace with certain permissions (see below). |
107-
| `GLOBAL_STORAGE` | integer |`10737418240`| Storage limit <MainPlatformName /> can use to store projects (last version) in bytes (default is 10 GB). Should be reasonably large. |
108-
| `LOCAL_PROJECTS` | string | `./projects` | Directory to store projects on container. Please refer to volume mapping in docker-compose file. |
109-
| `TEMP_DIR` | string | Result of `gettempdir()` call | Trash directory for temp files being cleaned regularly. Please refer to volume mapping in docker-compose file. |
110-
| `MAINTENANCE_FILE` | string |`/data/MAINTENANCE`| File to indicate server is in maintenance - read only mode. Please refer to volume mapping in docker-compose file. |
111-
| `BLACKLIST` | string | `.mergin/`, `.DS_Store`, `.directory` | Pattern to ignore when syncing files. |
112-
| `FILE_EXPIRATION` | integer | `172800` | When GeoPackage file was updated with "<NoSpellcheck id="diffable" />" change, original data are being removed (as they can be reconstructed on demand) to save disk space. File lifetime in seconds. |
113-
| `LOCKFILE_EXPIRATION` | integer | `300` | Time in seconds for project being locked while updated. If no change happens to project in such time, lockfile is removed. |
114-
| `MAX_CHUNK_SIZE` | integer | `10485760` | Maximum size of file chunk to be uploaded (and received by server) in bytes. |
115-
|`MAX_DOWNLOAD_ARCHIVE_SIZE`| integer | `1073741824`| Maximum size of project zip archive in bytes for direct download. Too large projects may take too long to download or never complete in one request. |
116-
| `USE_X_ACCEL` | Boolean | `false` | Whether to use nginx do serve files. Should be enabled if used with nginx proxy for performance reasons. Read more [here](https://www.nginx.com/resources/wiki/start/topics/examples/x-accel/). |
117-
|`CLOSED_ACCOUNT_EXPIRATION`| integer | `1` | Time in days after user closed his account to all projects and files are permanently deleted. Please note than until user is removed username/email is occupied. |
118-
| `DELETED_PROJECT_EXPIRATION`| integer| `7` | Lifetime in days for deleted project. Expired projects are removed permanently without possibility to restore afterwards. |
119-
| `PROJECT_ACCESS_REQUEST` | integer | `604800` | Lifetime of active project access request in seconds. |
120-
| `TEMP_EXPIRATION` | integer | `7` | Time in days after files in temporary folder are permanently deleted. |
104+
| Variable name | Type | Default | Description |
105+
|------------------------------|---------|-------------|---------------------------|
106+
| `GLOBAL_WORKSPACE` ⭐️ | string | `mergin` | Namespace (part of URL) for all projects. All projects belong to this single workspace with certain permissions (see below). |
107+
| `GLOBAL_STORAGE` ⭐️ | integer |`10737418240`| Storage limit <MainPlatformName /> can use to store projects (last version) in bytes (default is 10 GB). Should be reasonably large. |
108+
| `LOCAL_PROJECTS` | string | `./projects` | Directory to store projects on container. Please refer to volume mapping in docker-compose file. |
109+
| `TEMP_DIR` | string | Result of `gettempdir()` call | Trash directory for temp files being cleaned regularly. Please refer to volume mapping in docker-compose file. |
110+
| `MAINTENANCE_FILE` | string |`/data/MAINTENANCE`| File to indicate server is in maintenance - read only mode. Please refer to volume mapping in docker-compose file. |
111+
| `BLACKLIST` | string | `.mergin/`, `.DS_Store`, `.directory` | Pattern to ignore when syncing files. |
112+
| `FILE_EXPIRATION` | integer | `172800` | When GeoPackage file was updated with "<NoSpellcheck id="diffable" />" change, original data are being removed (as they can be reconstructed on demand) to save disk space. File lifetime in seconds. |
113+
| `LOCKFILE_EXPIRATION` | integer | `300` | Time in seconds for project being locked while updated. If no change happens to project in such time, lockfile is removed. |
114+
| `MAX_CHUNK_SIZE` | integer | `10485760` | Maximum size of file chunk to be uploaded (and received by server) in bytes. |
115+
| `MAX_DOWNLOAD_ARCHIVE_SIZE` | integer | `1073741824`| Maximum size of project zip archive in bytes for direct download. Too large projects may take too long to download or never complete in one request. |
116+
| `USE_X_ACCEL` ⭐️ | Boolean | `false` | Whether to use nginx do serve files. Should be enabled if used with nginx proxy for performance reasons. Read more [here](https://www.nginx.com/resources/wiki/start/topics/examples/x-accel/). |
117+
| `CLOSED_ACCOUNT_EXPIRATION` | integer | `1` | Time in days after user closed his account to all projects and files are permanently deleted. Please note than until user is removed username/email is occupied. |
118+
| `DELETED_PROJECT_EXPIRATION` | integer| `7` | Lifetime in days for deleted project. Expired projects are removed permanently without possibility to restore afterwards. |
119+
| `PROJECT_ACCESS_REQUEST` | integer | `604800` | Lifetime of active project access request in seconds. |
120+
| `TEMP_EXPIRATION` | integer | `7` | Time in days after files in temporary folder are permanently deleted. |
121121
122122

123123
#### Celery asynchronous tasks

0 commit comments

Comments
 (0)