Backup, Import & Export

Overview

Geergit provides comprehensive backup, import, and export functionality to help you manage app data across different profiles and maintain data consistency. This feature is particularly useful when you want to:

• Backup App Data — Automatically save app data (login information, preferences, settings) locally when creating or switching profiles
• Export Backups — Export all locally-backed-up app data to a selected location for storage, transfer, or recovery
• Import Backups — Restore previously exported app data backups to re-establish app configurations and login sessions

With the Backup App Data feature enabled, all app data is automatically backed up locally and can be exported or imported as needed. Note: Profile values and settings are stored on the server separately and are not affected by app data backups.

Prerequisites

• Alpha membership (required for Profiles features)
• Root access (required for app data backup and restoration)
• Backup App Data feature enabled in Geergit settings
• At least one profile with associated backup data
• A destination folder for exporting or a source folder containing previously exported backups for importing

!WARNING Backup and restore operations require root access. If root is not available, backups cannot be created or restored. Ensure Geergit has proper root permissions in your Xposed Framework settings.

Understanding Backup Storage

How Backups Are Created

When you enable Backup App Data and interact with profiles, Geergit automatically backs up app data locally on your device when creating or switching between profiles. This preserves login sessions, preferences, and other app-specific information.

Important: App data backups are stored only on your device locally. They are never sent to or stored on the Geergit server. Profile values and identity configurations are stored on the server separately from app data backups.

Export from Groups vs Individual Apps

Backups can be exported from two locations with the same process:

• Group Export — Exports backup data for all apps present in that group
• Individual App Export — Exports backup data for that specific app only

Both follow the identical export workflow.

Exporting Backups

Step 1: Open Group or Individual App

1. Launch Geergit
2. Select either a group or an individual app where you want to export backups from
3. You'll automatically be in the Identity section

Step 2: Access Settings

1. Look at the top-right corner of your screen
2. Click the gear icon (⚙️) to open Settings

Step 3: Navigate to Backup Section

1. After clicking the gear icon, you'll see several sections
2. Locate the "Backup" section
3. You'll see two options: "Import Backup" and "Export Backup"

Step 4: Start Export

1. Tap "Export Backup"
2. A file manager will open asking you to select a destination folder
3. Choose the folder where you want to export your backups

Step 5: Confirm and Export

1. After selecting the destination folder, tap "Use this folder"
2. You may be prompted to allow permissions — grant the necessary permissions
3. The export process will begin automatically
4. Wait for the export to complete

What Gets Exported

When exporting from a group:

• Backup data for all apps in that group
• All associated profile backups linked to those apps

When exporting from an individual app:

• Backup data for that specific app only
• All associated profile backups linked to that app

Importing Backups

Step 1: Select Group or Individual App

1. Launch Geergit
2. Select the group or individual app where you want to import backups
3. You'll automatically be in the Identity section

Step 2: Open Settings

1. Look at the top-right corner of your screen
2. Click the gear icon (⚙️) to open Settings

Step 3: Access Backup Section

1. After clicking the gear icon, locate the "Backup" section
2. You'll see two options: "Import Backup" (appears first) and "Export Backup"

Step 4: Select Import

1. Tap "Import Backup"
2. A file manager will open asking you to select a folder
3. Browse to the folder containing your previously exported backups

Step 5: Confirm Permissions and Complete Import

1. After selecting the folder, tap "Use this folder"
2. You may be prompted to allow permissions — grant the necessary permissions
3. Geergit will begin importing the backups from your storage into the app
4. Wait for the import process to complete

Important Notes About Backups

Exported Backup Folder Structure

When you export backups, do not rename or modify the exported backup folders in any way. Keep the folder structure exactly as it was exported, or Geergit will not be able to detect and import the backups.

What Are App Data Backups?

App data backups contain login information, preferences, and app-specific settings from your installed apps. These backups are:

• Stored locally only — App data backups are stored only on your device
• Never sent to server — App data backups are never uploaded to or stored on the Geergit server
• Separate from profile values — Profile values (identity configurations) are stored on the server independently and are always available

Account Requirement

Critical: Backups are account-specific and can only be imported into the same account they were exported from.

• If you export backups from Account A, you can only import them into Account A
• You cannot import backups from Account B into Account A, or vice versa
• Ensure you're using the same Geergit account for both export and import

Related Topics

• Profiles Overview — Learn about creating and managing profiles
• Select Profile — Learn how to apply profiles to apps
• Importing .den Files — Import configurations from Device Emulator
• Identity Management — Manage individual identity fields