Update Package Lists
Before installing new software, it's always a good idea to update your package lists to ensure you're getting the latest versions:
sudo apt update
Wine is not found or not properly installed
Make sure Wine is installed on your system. You can usually install it with:
sudo apt install wine64 wine32
Then run winecfg once to complete the setup.
Winetricks is not installed
CrossLink requires winetricks to install Windows dependencies. Install it using your package manager:
sudo apt install winetricks
No output or empty logs when running .exe
Check that the executable is valid and compatible with Wine. Some applications require additional components (e.g. .NET, DirectX).
Try installing common dependencies using the Install Dependencies section in CrossLink.
Issues with creating or selecting bottles
Bottles are stored in ~/.local/share/crosslink_bottles. If bottle creation fails:
- Ensure you have write permission to that directory
- Make sure
winecfgcan run in your environment - Try restarting CrossLink and creating a new bottle
Other errors or crashes
Watch the activity log for specific error messages. These often indicate missing packages, Wine misconfiguration, or broken .exe files.