Skip to content

Global Settings

Global settings are accessed by tapping "Settings" in the menu.

General

Language

Supported languages:

  • Simplified Chinese
  • Traditional Chinese
  • English
  • Follow System

If the system language is not in the supported list, English is used by default.

Dark Mode

Options:

  • Follow System
  • Light
  • Dark

Changes are applied to the app interface immediately.

Background Connection Timeout

Controls how long domain connections are maintained after the app enters the background.

Available values:

  • 1 minute
  • 3 minutes
  • 5 minutes (default)
  • 10 minutes
  • 15 minutes
  • 30 minutes
  • Never disconnect

After the timeout, all domain connections are disconnected and the app enters a dormant state to save battery. When returning to the foreground, domains with auto-connect enabled will automatically come back online.

If you need to maintain domain connections for extended periods in the background (for example, to receive instant messages), you can select "Never disconnect," but this will increase battery consumption.

This setting can also be modified in the OmniGate page of the iOS system Settings app.

Cache Statistics and Clearing

The settings page displays cache usage and supports clearing the cache.

The clearing scope includes:

  • WebKit, URLSession, and system caches.
  • Temporary files.
  • File manager transfer files.

It will not clear:

  • Domain configurations.
  • Resource configurations.
  • SSH private keys.
  • Language and appearance settings.
  • Tailscale / ZeroTier domain login or identity configurations, unless the corresponding implementation stores this data in the clearable cache directory.

Configuration Backup and Restore

Configuration backup and restore is a Pro feature. Tapping it in the free version will take you to the Pro purchase page.

Export Configuration

Export packages all current configurations into a single JSON file:

  • Domain configurations
  • Resource configurations
  • SSH private keys and settings
  • Language and appearance preferences
  • File manager settings

The export file includes the app version number, build number, and backup time. Backup files are signed with HMAC-SHA256 to prevent tampering. If the signature verification fails, the import will refuse to restore.

After exporting, you can save the file via system sharing to Files, AirDrop, or other apps.

Import Configuration

Import overwrites all current configurations. It is recommended to export your current configuration as a backup before importing.

Configurations from different versions may be incompatible. Before restoring, confirm that the backup file's source version is compatible with the current version.

Resources

Files

You can configure whether the file list displays common file icons.

SSH

You can configure:

  • Terminal font.
  • Terminal theme.
  • SSH private keys.

SSH private key management supports:

  • Pasting an existing private key.
  • Generating a new Ed25519 private key.
  • Copying the public key.
  • Saving the private key passphrase, or entering it temporarily when connecting.

OmniGate User Manual