Troubleshooting & Solutions

Solution:

1. Make sure you have administrator privileges. Right-click the installer and select "Run as administrator"
2. Check if your antivirus is blocking the installation. Temporarily disable it or add Ferdium to exceptions
3. Ensure you have enough disk space (at least 500MB free)
4. Download the installer again from the official website - the file may be corrupted
5. Check Windows Defender SmartScreen - click "More info" and "Run anyway" if prompted

Solution:

1. If you get "Ferdium.app is damaged and can't be opened", this is usually a macOS Gatekeeper issue
2. Go to System Preferences > Security & Privacy > General
3. Click "Open Anyway" if the option appears after attempting to open Ferdium
4. Alternatively, run this command in Terminal: xattr -cr /Applications/Ferdium.app
5. Then try opening Ferdium again

Solution:

1. Make the AppImage executable: chmod +x Ferdium-*.AppImage
2. If you still can't run it, check if FUSE is installed: sudo apt install fuse (Ubuntu/Debian)
3. On some systems, you may need to extract and run: ./Ferdium-*.AppImage --appimage-extract-and-run

Solution:

• Clear the service's cache: Right-click the service → Settings → Clear Cache
• Reload the service: Right-click → Reload Service (or press Cmd/Ctrl + R)
• Check your internet connection
• Try removing and re-adding the service
• Update Ferdium to the latest version
• Check if the service website is accessible in your browser

Solution:

• Make sure you're entering the correct credentials
• Try signing in to the service in a regular browser first to verify your account works
• Clear cookies for the service: Right-click → Settings → Clear Cookies
• Some services require two-factor authentication - make sure you complete that step
• Check if the service has changed its login page - you may need to update the service recipe

Solution:

• Check the service's session timeout settings - some services log you out after inactivity
• Don't clear cookies if you want to stay logged in
• Enable "Keep service active" in service settings to prevent hibernation
• Make sure you're not using private/incognito mode settings
• Some services detect unusual activity and log you out for security - contact the service support

Solution:

• Check system notification permissions (macOS: System Preferences > Notifications; Windows: Settings > System > Notifications)
• Enable notifications in Ferdium Settings > Privacy
• Check if notifications are enabled for the specific service (Right-click service → Settings)
• Make sure the service tab is not muted
• Restart Ferdium after changing notification settings
• On Linux, ensure your desktop environment supports notifications (install libnotify if needed)

Solution:

• Disable browser notifications within the service itself (many services have their own notification settings)
• Use Ferdium's notification settings to control which services can notify you
• Enable "Quiet hours" in Settings to silence notifications during specific times
• Check if you have the same service added multiple times - each instance will notify separately

Solution:

• Enable service hibernation in Settings > General - services will sleep when not in use
• Reduce the number of active services - hibernate or close services you're not using
• Close services you don't need right now instead of keeping them all open
• Clear cache for services: Right-click service → Settings → Clear Cache
• Update to the latest version of Ferdium - performance improvements are released regularly
• Restart Ferdium periodically if you use it for extended periods

Solution:

• Reduce the number of services that auto-start on launch
• Disable auto-start for services you don't need immediately
• Check if your antivirus is scanning Ferdium files on startup
• Move Ferdium to an SSD if you're using a traditional hard drive
• Clear old cache files from Ferdium's data directory