Release: Wombat

Wombat is the current DocsHub architecture.

Read the Roadmap

Troubleshooting #

Desktop application #

Application won’t start #

Symptom: Double-clicking the app does nothing, or an error dialog appears.

Solutions:

1. Check Python version:

   python --version
   

   Requires Python 3.10 or later.

2. Verify installation:

   pip install -e '.[gui]'
   

3. Check for display server (Linux):

   export QT_QPA_PLATFORM=offscreen
   accountsplus-gui
   

Database is locked #

Symptom: “database is locked” error when saving.

Solutions:

1. Close other instances of AccountsPlus
2. Wait a moment and try again
3. Restart the application
4. If persistent, check file permissions on the database

PDF generation fails #

Symptom: Error when generating invoice PDFs.

Solutions:

1. Verify reportlab is installed:

   pip install reportlab
   

2. Check write permissions for output directory

3. Try a different output location:

   accountsplus invoice pdf <uuid> --output /tmp/invoice.pdf
   

CLI #

Command not found #

Symptom: accountsplus: command not found

Solutions:

1. Ensure virtual environment is activated:

   source .venv/bin/activate
   

2. Or run with Python:

   python -m accountsplus.cli --help
   

3. Reinstall with entry points:

   pip install -e '.[cli]'
   

Permission denied #

Symptom: “Permission denied” when running commands.

Solutions:

1. Check file permissions:

   ls -la ~/.local/share/accountsplus/
   

2. Fix permissions:

   chmod -R 755 ~/.local/share/accountsplus/
   

3. Don’t run as root/sudo

Sync #

Connection refused #

Symptom: Cannot connect to sync server.

Solutions:

1. Verify server URL:

   accountsplus sync status
   

2. Check internet connection:

   ping sync.accountsplus.app
   

3. Ensure server is running (self-hosted)

4. Check firewall settings

Authentication failed #

Symptom: Login fails with correct credentials.

Solutions:

1. Reset password on the server

2. Check for account lockout:

   • Wait 15 minutes if locked out
   • Verify email address

3. Generate new token:

   accountsplus sync disconnect
   accountsplus sync connect --server <url> --business <uuid>
   

Conflicts detected #

Symptom: Yellow warning in sync status.

Solutions:

1. View conflicts:

   accountsplus sync conflicts
   

2. Resolve each conflict:

   accountsplus sync resolve <id> --resolution local
   

3. Sync again after resolution

Sync stuck / not progressing #

Symptom: Sync indicator keeps spinning.

Solutions:

1. Check internet connection

2. Disconnect and reconnect:

   accountsplus sync disconnect
   accountsplus sync connect --server <url> --business <uuid>
   

3. Restart application

4. Check server status (if self-hosted)

Android app #

Cannot connect to server #

Solutions:

1. Verify server URL in Settings

2. Check internet connection on device

3. Ensure credentials are correct

4. Try opening the server URL in a browser

No data showing #

Solutions:

1. Pull data manually: Settings > Sync Now

2. Verify you’re logged in with the correct account

3. Check server connection status

App crashes on startup #

Solutions:

1. Clear app data in Android settings

2. Uninstall and reinstall

3. Check Android version (requires 8.0+)

Data recovery #

Accidentally deleted data #

Important: If you have a backup, restore it immediately.

Without a backup:

1. Check if sync server has the data
2. Pull from server:

   accountsplus sync pull
   

3. If not in sync, data may be unrecoverable

Corrupted database #

Solutions:

1. Check for backup files:

   ls ~/.local/share/accountsplus/backups/
   

2. Restore from backup:

   accountsplus restore <backup-file>
   

3. If no backup, try SQLite recovery:

   sqlite3 accountsplus.db ".recover" | sqlite3 recovered.db
   

Getting help #

If you encounter issues not covered here:

1. Check the GitHub issues
2. Search existing issues for similar problems
3. Create a new issue with:
   • Operating system and version
   • AccountsPlus version
   • Steps to reproduce
   • Error messages