🆘 Troubleshooting
Written by Russo · Updated: July 2025
⚠️ Common Issues & Fixes
Locanox is designed to work without external servers or automatic sync. Most problems are caused by missing permissions or device-level restrictions.
🔒 App Won’t Open or Crashes
Ensure your device allows storage, memory, and local file access.
- Clear Locanox app cache and restart
- Try launching in Airplane Mode (for offline isolation testing)
- Check if antivirus software is blocking the app
- Verify sufficient device storage space available
🧠 AI Chat Not Responding
Make sure your device meets the minimum RAM requirement (2GB+).
- Check if the AI model has been downloaded completely during setup
- Restart the app and try again offline
- Clear AI cache if responses become slow or inconsistent
- Ensure device isn’t in power-saving mode
📁 Vault Not Saving or Unlocking
Confirm device biometric/PIN access is enabled.
- Make sure file system storage permission is granted
- Restart device if using custom ROM or privacy sandbox
- Check if vault file permissions are properly set
- Try importing vault backup if corruption suspected
🌐 Online Features Not Working
Ensure you are connected to the internet.
- Check if your relay connection is properly configured
- Try switching between default and custom relay options
- Verify firewall isn’t blocking encrypted connections
- Test with different network (mobile data vs WiFi)
📷 Image Placeholder
[Insert graphic here: A diagnostic screen showing common troubleshooting steps with checkmarks, error icons, and solution pathways. Include device icons and Locanox branding.]
🔧 Advanced Troubleshooting
Performance Issues
If Locanox runs slowly:
- Close other resource-intensive apps
- Restart device to clear memory
- Check available storage space
- Reduce AI model complexity if needed
Network Connectivity Problems
If online mode fails to connect:
- Test internet connection with other apps
- Check for VPN interference
- Verify DNS settings aren’t blocking connections
- Try connecting from different network
Vault Corruption
If vault becomes inaccessible:
- Never delete the vault file immediately
- Try importing from most recent backup
- Check if device encryption is interfering
- Contact support with error details (no personal data needed)
📱 Platform-Specific Issues
Android
- App won’t start: Check if Developer Options are enabled
- Storage issues: Clear cache via Settings > Apps > Locanox
- Permission denied: Manually grant storage/file access
- Battery optimization: Disable for consistent performance
Desktop (Windows/Mac/Linux)
- Startup problems: Run as administrator/sudo if needed
- File access: Check folder permissions in app directory
- Antivirus interference: Add Locanox to whitelist
- Display issues: Try different screen resolution settings
iOS (When Available)
- App crashes: Force close and restart
- Storage problems: Check iOS storage settings
- Sync issues: Disable iCloud sync for Locanox data
- Touch ID/Face ID: Reconfigure biometric authentication
🔍 Diagnostic Steps
Basic Troubleshooting Checklist
- Restart the app - Close completely and reopen
- Check device resources - Available RAM and storage
- Verify permissions - Storage, biometric, network access
- Test in offline mode - Ensure basic functionality works
- Review error messages - Note exact wording for support
Advanced Diagnostic
- Check vault integrity - Verify backup can be imported
- Test network isolation - Try airplane mode functionality
- Review device logs - Look for Locanox-related errors
- Try minimal setup - Fresh install with basic configuration
- Document issue pattern - When it occurs, frequency, triggers
🛠️ Self-Help Resources
Built-in Tools
- Vault verification - Check encryption integrity
- Connection test - Verify relay functionality
- Storage cleanup - Clear temporary files
- Export logs - Generate diagnostic information
Manual Fixes
- Reset app preferences - Return to default settings
- Reimport vault - Use backup file to restore
- Clear AI memory - Reset chat history if corrupted
- Rebuild index - Refresh file organization
🚨 When to Contact Support
Contact support if:
- Vault corruption cannot be resolved with backups
- Security-related concerns or suspicious behavior
- Persistent crashes after following troubleshooting steps
- Online features completely non-functional
- Data loss despite following backup procedures
Before contacting support:
- Try all relevant troubleshooting steps
- Document the exact error or problem
- Note your device type, OS version, and app version
- Prepare to describe steps that reproduce the issue
🔐 Security Troubleshooting
Biometric Authentication Issues
- Reconfigure biometric settings in device settings
- Clear biometric cache and re-register
- Test with PIN backup if biometrics fail
- Check for OS-level biometric updates
Encryption Problems
- Verify vault password is entered correctly
- Check for keyboard input issues (language, layout)
- Test vault on different device if possible
- Ensure encryption algorithms are supported
Privacy Concerns
- Review app permissions regularly
- Check for unexpected network activity
- Verify offline mode is truly offline
- Monitor background processes for anomalies
Remember: Locanox is designed for maximum privacy and offline functionality. Most issues can be resolved locally without compromising your data or requiring external assistance.