Differences

This shows you the differences between two versions of the page.

--- manual:user_guide:settings:backup_fsys [2022/12/07 15:49] – created mstupka
+++ manual:user_guide:settings:backup_fsys [2025/09/24 16:06] (current) – mstupka
@@ Line 1: / Line 1: @@
 ====== Backup & filesystem ======
-<WRAP center round todo 60%>
-todo box
-</WRAP>
 ----
 ===== File system manager =====
 Allows customizing Locus Map default working directories.
-=== Set the main directory ===
+==== Set the main directory ====
-<WRAP center round important>
-**Android 11+**
-The app is forced to have the main directory in its **private folder** in ///Android/data/// system directory. Either in the internal storage or on the external SD card.
+By default, Locus Map's main data is stored in its **private folder** in ///Android/data/// sector of the internal storage (///Android/data/menion.android.locus/files/Locus///). You can also move it to:
-</WRAP>
+  * ///Android/media/// sector - better accessible for the user and other apps like the photo gallery, etc.
+  * both ///Android/data/// and ///Android/media/// sectors on the external SD card
+=== How to do it: ===
-By default, Locus main directory is stored in the root of your device's **internal storage**. You can move it also to the **private directory** both in the **inner storage** or on **external SD card**:\\ {{ :manual:user_guide:settings:settings_53.jpg?nolink |}}
+  * tap the selected storage
-  * tap the selected option
   * tap "**MOVE**"
   * the app calculates the size of the data for transfer
   * app transfers the data to the new location
   * app requires **restart**
+{{ :manual:user_guide:settings:settings_53.jpg?nolink |}}
-If you want only to select a different location for the main app directory - **without data transfer** - tap {{:manual:user_guide:ic_more_ver_alt.png?nolink&20|}} menu next to the selected option and then tap **select**:\\ {{ :manual:user_guide:settings:settings_64.jpg?nolink |}}
+If you only want to select a different location for the main app directory **without data transfer**, tap {{:manual:user_guide:ic_more_ver_alt.png?nolink&20|}} menu next to the selected option and then tap **select**:\\ {{ :manual:user_guide:settings:settings_64.jpg?nolink |}}\\ :!: Be aware that this way you will **lose access to your Locus Map data** which remains in the former storage.
-=== Set custom sub-directories ===
+<WRAP center round info>
-Some sub-directories can be placed out of the default main directory.\\ {{ :manual:user_guide:settings:settings_65.jpg?nolink |}}
+On Android 10 and older versions of the operating system, Locus Map has its main directory at the root of the internal storage - ///sdcard/Locus///.
+</WRAP>
-) in the app **private folders** (either in internal storage or external SD card):
+==== Set custom sub-directories ====
-  * ///Maps/// - raster maps
+Some sub-directories can be placed outside the default main directory.\\ {{ :manual:user_guide:settings:settings_65.jpg?nolink |}}
-  * ///MapsOnline/// - definition files, temp data of online maps
-  * ///geocaching/// - user images, spoilers, HTML listings, offlinized data etc.
-) anywhere in the device storage:
+) in the app's **private folders** in internal storage, external SD card or ///Android/Media/// directory:
-  * ///MapsVector/// - vector maps, e.g. LoMaps or OpenAndroMaps
+  * **Maps** - raster maps
-  * ///SRTM/// - offline elevation dat
+  * **MapsOnline** - definition files, temp data of online maps
-  * ///Backup/// - ZIP files with backup of tracks, routes, points and settings
+  * **MapsVector** - vector maps, e.g., LoMaps or OpenAndroMaps
+  * **geocaching** - user images, spoilers, HTML listings, offlinized data, etc.
+  * **SRTM** - offline elevation data
+) **anywhere** in the device storage:
+  * **Backup** - ZIP files with the backup of tracks, routes, points, and settings
+If you want to **CHANGE** the location of any sub-directory, please do the following:
+  * **tap** the selected sub-directory
+  * select the **target storage**
+  * **confirm** data transfer (without confirming, the custom subdirectory will be set, but the original data will remain in the default one)
+  * after the change, the app needs a **restart**\\ {{ :manual:user_guide:settings:settings69.gif?nolink |}}
+----
+===== Cloud synchronization =====
+<wrap info>Available only with **[[https://www.locusmap.app/premium|Premium Gold]]**</wrap>
+=== About ===
+Tracks, routes, and points can be **synchronized across many devices** through our cloud sync service. This is done automatically, always after any change made to the database - when a track is recorded, a route planned, a point imported... The sync unifies the database content with all other devices **running the same Google account**.
+==== First sync ====
+  * take the device on which you have the **oldest Locus data** (tracks, routes, points). This device should ideally have all your complete data
+  * open your **Library** and tap the sync button in the topbar menu:\\ {{ :manual:user_guide:mylib38.jpg |}}
+  * **confirm manual synchronization** and let it go all the way through:\\ {{ :manual:user_guide:sync01.jpg?nolink |}}
+  * **your personal database on the cloud has been created** – you can sync other devices or plan/save routes in the [[https://web.locusmap.app|web planner]]
+==== Automatic sync ====
+After the first sync, the automatic synchronization is **turned on by default**. If any change happens to your database (track is recorded or imported, a route is planned, points are imported...), it is immediately synced with the cloud.
+**Automatic sync can be turned off in the settings.**
+<WRAP center round info>
+**How does sync work?**
+The synchronization algorithm is based on the modification time. The last modification wins. During each synchronization, the data from your mobile phone and the data in the cloud are compared. Based on the modification time, it is decided what action will be done (none, upload, download, delete locally, delete on the server, ...). It doesn't matter how many devices you have. The synchronization mechanism is still the same.
+But you should be careful about one situation - during a sync process on multiple devices, also DELETIONS are synchronized. That means **when you delete some data on one device, the same data will be deleted on all other synced devices.**
+</WRAP>
+==== Settings ====
+{{ :manual:user_guide:sync02.jpg?nolink |}}
+  * **Automatic sync** - here you can turn it ON or OFF (ON is the default)
+  * **Wifi-only connection** - turn ON if you want to save your precious cell data
+  * **Show new points** - when turned ON, the newly synced points are shown on the map screen (not applied for the initial sync)
+  * **Show new tracks** - when turned ON, the newly synced tracks/routes are shown on the map screen (not applied for the initial sync)
+==== Troubleshooting ====
+When there is any problem with syncing, you can get information about the last sync action in the topbar menu:\\ {{ :manual:user_guide:sync03.jpg?nolink |}}
+  * **Last update** - generates a log with information about the last syncing action. Use when communicating with the helpdesk
+==== Advanced options ====
+Also available in the topbar menu.
+  * **Compute sync plan** - simulates the future syncing process
+  * **Full download** - removes all tracks, routes, and points from Locus Map and downloads the synced data from the cloud
+==== Cloud ====
+Locus Map is synchronized with cloud storage. Its contents can be viewed in the **web library** and edited in the **web planner** at **[[https://web.locusmap.app|web.locusmap.app]]**\\ {{ :manual:user_guide:sync04.jpg?nolink |}}
+----
+===== Backup manager =====
+We strongly recommend backing up your Locus data - **tracks, routes, points, and settings**. This tool enables the definition of **periodic automatic backups** and triggers manual **one-time backups**.
+==== Automatic backup ====
+{{ :manual:user_guide:settings:backup01.jpg?nolink |}}
+... saves Locus data periodically to //Locus/backup/auto// directory and optionally to **Dropbox, OneDrive or <del>Google Drive</del>**. How to set it up:\\ {{ :manual:user_guide:settings:backup02.jpg?nolink |}}
+  - **Enable** automatic backup
+  - set what you want to backup - the default is all:\\ {{ :manual:user_guide:settings:backup03.jpg?nolink |}}
+  - Set **repetition frequency**, **number** of stored backups and backup to **cloud** (optional but strongly recommended):
+=== Backup to cloud ===
+Automatically backs up selected Locus data to your selected directory at Dropbox, One Drive, or <del>Google Drive</del>:
+  * **enable** the option
+  * select your favorite **cloud drive**:\\ {{ :manual:user_guide:settings:backup04.jpg?nolink |}}
+  * **log in** and **allow access** for Locus Map
+  * **select/create a folder** for the backup files and **confirm**:\\ {{ :manual:user_guide:settings:backup05.jpg?nolink |}}
+<WRAP important round>
+  * **Attached media (photos, videos...) are not backed up**
+  * **Maps are not backed up this way.** They are automatically backed up on our servers; some third-party maps are backed up a [[manual:user_guide:maps_offline#cloud_backup_of_maps|different way]].
+  * Xiaomi devices with MIUI 12+ - make sure you have **"MIUI optimizations" turned ON** in system settings > developer options
+  * **Since September 2025, Locus Map has not supported Google Drive as it was denied full access to the service.**
+</WRAP>
+==== Manual backup ====
+{{ :manual:user_guide:settings:backup06.jpg?nolink |}}
+Saves a single backup file with Locus data to //Locus/backup/// directory (it can be changed in //settings > Backup & File system > File system manager > Set custom sub-directories//). The file name is by default the **time stamp**, but it can be changed.\\ {{ :manual:user_guide:settings:backup07.jpg?nolink |}}
+  - **set** what you want to backup (the same selection as with the automatic backup)
+  - set backup to **cloud** (optionally, the same way as with the automatic backup)
+==== App migration backup ====
+{{ :manual:user_guide:settings:backup10.jpg?nolink |}}
+This command triggers a process of packing **all the app's data** (maps, tracks, points, settings, attachments...) **into one ZIP file**, which can be used as a general backup when you need to start using Locus Map on another device. The file can be very large, and the app informs about the **required space** for storing it:\\ {{ :manual:user_guide:settings:backup11.jpg?nolink |}}
+The backup file is stored in the ///Locus/backup/// directory, but upon its finishing, an option to **share it with Dropbox** and other services is offered.
+==== Restore from backup ====
+  * select **storage** where the backup file is stored:\\ {{ :manual:user_guide:settings:backup08.jpg?nolink |}}
+  * select the **backup file**. It starts downloading and then its content is analyzed
+  * you are prompted to select **what content of the package you want to restore**:\\ {{ :manual:user_guide:settings:backup09.jpg?nolink |}}
+  * **restart** Locus Map
+<WRAP center round important>
+Restore from backup **overwrites all related data**. Keep this in mind, especially regarding your tracks, routes, and points.
+</WRAP>
+----
+===== App data transfer =====
+<wrap info>Relevant only for Android 11+ devices only.</wrap>
+==== Load app data ====
+It searches the device storage for the app's main directory, provided it is not placed in the current location. Used in case the user cancels the data transfer after an update on Locus Map version 4.5.x. and newer.
+==== Unload app data ====
+It moves all data of the app out of its main directory to a selected part of the storage. Used above all when reinstalling the app with the main storage in the private directory, which is usually removed by the uninstall.
+==== Load Locus Map Classic data ====
+Triggers the process of transferring data from the sister app's main directory to the current main directory.
+----
+===== Clear temporary data =====
+Deletes temporary storage folders:
+  * **Temporary files** - deletes cache directory
+  * **Cache of online maps** - deletes all cached online map tiles
+  * **Unneeded geocaching data** - deletes all cached data of geocache points that have been removed before
+  * **Unused attachments** - deletes all data linked to previously removed points
+<WRAP round alert >
+**Warning**: after performing this procedure, all icons will have to be re-uploaded, and new map initialization files will have to be created
+</WRAP>

knowledge base

User Tools

Site Tools

Differences