Troubleshooting
Solutions to common PrivStack issues.
App Won’t Start
Windows
- Check if another instance is running (system tray)
- Try running as administrator
- Check Windows Event Viewer for errors
- Reinstall if needed
macOS
- Check Activity Monitor for running instances
- Try:
xattr -cr /Applications/PrivStack.app - Check Console.app for errors
- Reinstall if needed
Linux
- Run from terminal to see errors
- Check permissions on data folder
- Ensure required libs are installed
Sync Issues
Devices Not Connecting
- Ensure both devices are on the same network (for local sync)
- Check that sync is enabled on both devices
- Verify device IDs match
- Check firewall settings (port 21000)
Sync Stuck
- Go to Settings > Sync
- Click Force Sync
- If still stuck, click Reset Sync State
Cloud Sync Not Working
- Check internet connection
- Re-authenticate with cloud provider
- Check available storage space
Performance Issues
App Running Slow
- Check how many items you have (very large databases may be slower)
- Close unused modules
- Restart the app
- Check system resources (RAM, CPU)
Large Files Slow
Encrypted file operations take time. For many large files:
- Wait for operations to complete
- Consider splitting into smaller batches
Data Issues
Missing Data
- Check if you’re on the right device
- Check sync status — data may not have synced yet
- Check filters — items may be filtered out
- Look in Trash (deleted items)
Corrupted Data
- Go to Settings > Backup > Restore
- Choose a recent backup
- Contact support if backups are also affected
Log Files
Find logs for support:
- Windows:
%APPDATA%\\PrivStack\\logs - macOS:
~/Library/Logs/PrivStack - Linux:
~/.local/share/PrivStack/logs
Getting Help
- Check this documentation
- Search our FAQ
- Contact support with:
- Your platform (Windows/macOS/Linux)
- PrivStack version
- Description of the issue
- Relevant log files (no sensitive data)