Quick Fixes and Causes
How the Problem Typically Manifests
the application fails to launch
an error is displayed (e.g. settings.xml is corrupted or a general application error)
the application freezes during loading / update (download stuck at 0%)
Possible Causes and Solutions
1. Corrupted Cache or Configuration
Symptoms:
error "
Soubor settings.xml je poškozen nebo nepřístupný...", or "settings.xml is corrupted"the application fails to launch or freezes
Solution:
Delete the application cache.
Windows:
C:\Users\<uživatel>\.winstrom\cache
macOS / Linux:
~/.winstrom/cache/
If that does not help, also delete settings.xml:
Windows:
C:\Users\<uživatel>\AppData\Roaming\.winstrom\cache\settings.xml
macOS / Linux:
~/.winstrom/settings.xml
⚠️ What happens after clearing the cache?
the application will reinitialize
a "clean" environment may appear
your data in Flexi will be preserved
2. Unable to Launch During Automatic Client Update
Flexi automatically updates the client to match the server version.
Symptoms:
the application freezes on "downloading files" (e.g. at 0%)
data fails to load
Solution:
close the application
clear the cache (see above)
relaunch the application
3. Client ↔ Server Version Mismatch
The client and server are running different versions.
Symptoms:
general application error
in the log, for example:
Client version 'X' is different from server 'Y'
Solution:
allow the automatic client update to complete
alternatively, manually install the latest version of the client
How to check the server version:
in the desktop application: Help → About ABRA Flexi → Application Details