DocsTroubleshooting & FAQCommon Issues and Solutions
Common Issues and Solutions
Quick fixes for the most frequent problems: installation, sign-in, vault unlock, sync, files, and billing. If you’re stuck, check System Status and then follow the steps below.
App won’t install or launch
Windows
- Run installer as Admin if policy blocks it
- Allow through SmartScreen: More info → Run anyway
- Verify checksum & signature (see guide)
macOS
- Drag app from DMG to Applications
- System Settings → Privacy & Security → Open Anyway
- Check
spctl
/codesign
verification if needed
Linux
- Make AppImage executable:
chmod +x bervice.AppImage
- Install deps:
libfuse
/glibc
LTS - Launch from terminal to see errors
Can’t sign in or unlock vault
Sign-in issues
- Check email code (spam/filters) or wallet signature prompt
- Verify time/date sync on your device
- Disable VPN/proxy temporarily for login
Vault unlock
- Master password is case-sensitive; try last known
- If lost, restore with recovery seed/key file (we can’t reset it)
- Ensure correct vault path (external drives mounted)
New device? Use Restore existing vault and your recovery materials. See Account Setup.
Sync stuck, slow, or conflicting
- Check Status: /status for incidents or maintenance
- Retry: Toggle Settings → Sync off/on; restart app
- Network: Try another network/VPN; ensure proxy allows app traffic
- Clock skew: Enable automatic time sync
- Conflicts: Open the item → resolve by keeping newer or merging fields
Still failing? Export logs and submit a ticket with timestamps.
File upload/download problems
- Check plan quota in Settings → Storage
- Large files: keep app open until “Uploaded” state appears
- Filename issues: remove special characters and retry
- External drive paths: ensure stable mount & permissions
Subscription shows “Pending” or “Inactive”
- Wait for network finality (typically < 1 minute)
- Open Settings → Subscription → Refresh
- Confirm correct chain/network in your wallet
- Verify TX hash in Billing history (block explorer)
- Grace period applies for failed renewals—then downgrade to Free
See Subscription Management and Payment Options.
Wallet not detected / transaction fails
- Unlock wallet; approve site connection
- Switch to network shown at checkout
- Ensure funds for amount + gas
- Hardware wallet: update firmware/bridge and reconnect
App feels slow or high CPU
- Update to latest version (signed, auto-updates)
- Large vaults: enable incremental sync; limit open tabs
- Check security software exclusions for the app directory
- SSD recommended; verify disk health and free space
Backup & recovery questions
- Keep recovery seed/key file offline (USB, printed QR)
- Test restore on a second device periodically
- Never share master password, seeds, or key files
Export/Import issues
- Use File → Export to produce encrypted archives or CSV/JSON (no secrets in plaintext when sharing)
- Import: map fields correctly; app re-encrypts locally
- Check encoding (UTF-8) and column headers for CSV
CLI errors
- Run
bervice-cli --version
and verify path - macOS/Linux:
chmod +x
and correct shell profile - Windows: use PowerShell; allow script execution if required