First install: make sure the client opens
After installation, open the main window and check that the settings page loads before importing a configuration. Re-entering a subscription URL won’t help if the main window won’t open. On desktop, check the runtime environment or installation message; on mobile, distinguish an installer error from an app startup error. When asking for help, include the system version, architecture, downloaded filename and full error message. Keep screenshots limited to what’s needed for troubleshooting.
Once the client opens, choose an import method based on your configuration source. Add a full subscription under subscription groups; import an individual share link using the share-link option. An empty list doesn’t necessarily indicate an installation problem: the URL may not have refreshed, the format may be unsupported, or a filter may be showing a different group.
Installation and subscription import guide →
Before upgrading: back up your local configuration
Refreshing a subscription downloads remote configuration; it doesn’t back up your local settings. Connections you added manually, custom groups, routing rules and proxy modes may need to be saved separately. Use the client’s backup or export feature if available, and store the backup outside the installation folder so an update can’t overwrite it.
After upgrading, open the app and check your groups and custom rules, then test a connection that worked before. Don’t change the core, routing settings and subscription all at once, or it’ll be hard to identify the cause of a problem. If you roll back, first check whether the older version can read the newer configuration. Then decide whether to restore an older backup or import the configuration again.
Configuration and maintenance guide →