accountsplus documentation
Choose a version
Version 1.x
Sync and cloud backup #
AccountsPlus supports optional cloud synchronization to keep your data backed up and accessible across multiple devices.
Overview #
The sync system works like git:
- Each device maintains a complete local copy of your data
- Changes are tracked with version numbers
- You can push local changes and pull remote changes
- Conflicts are detected and flagged for resolution
Requirements #
- Active cloud sync subscription
- AccountsPlus 1.0.0 or later
- Internet connection
Connect to sync server #
From the GUI #
- Go to Sync > Connect
- Enter the server URL (e.g.,
https://sync.accountsplus.app) - Enter your email and password
- Select your business
- Click Connect
From the CLI #
accountsplus sync connect --server https://sync.accountsplus.app --business <uuid>
Sync your data #
Automatic sync #
When connected, AccountsPlus automatically syncs every 30 minutes. You can also trigger a manual sync.
Manual sync #
GUI #
Click the sync status indicator in the status bar, or go to Sync > Sync Now.
CLI #
accountsplus sync sync
This performs both push and pull operations.
Push changes #
Push your local changes to the server:
accountsplus sync push
Pull changes #
Pull changes from other devices:
accountsplus sync pull
Sync status #
Check sync status #
accountsplus sync status
Displays:
- Last sync time
- Server version
- Pending changes
- Conflicts
Status bar #
The status bar shows:
- Connected: Green indicator, last sync time
- Syncing: Blue spinning indicator
- Offline: Gray indicator
- Conflicts: Yellow warning indicator
Conflict resolution #
When the same record is modified on multiple devices before syncing, a conflict is detected.
View conflicts #
accountsplus sync conflicts
Or from the GUI: Sync > View Conflicts
Resolve conflicts #
For each conflict, you can choose:
- Keep Local: Use your device’s version
- Keep Remote: Use the server’s version
- Skip: Ignore this conflict for now
accountsplus sync resolve <conflict-id> --resolution local
From the GUI: Select a conflict and click Resolve.
Offline mode #
If you lose internet connection:
- AccountsPlus continues to work normally
- Changes are stored locally
- When reconnected, changes sync automatically
- Conflicts are flagged if the same records were modified
Data privacy #
- Your data is encrypted in transit (TLS)
- Data at rest is encrypted on the server
- Only you have access to your encryption keys
- ZFordDev cannot read your financial data
Backup #
Even with sync enabled, regular backups are recommended.
Automated backups #
Configure automatic backups in Preferences > Backup:
- Daily, weekly, or monthly
- Choose backup location
- Set retention period
Manual backup #
accountsplus backup --output ~/backups/manual-backup.enc
Troubleshooting #
“Connection refused” #
- Verify the server URL
- Check your internet connection
- Ensure your subscription is active
“Authentication failed” #
- Re-enter your credentials
- Check if your password has changed
- Contact support if the issue persists
“Conflicts detected” #
- Review conflicts in Sync > View Conflicts
- Resolve each conflict individually
- After resolution, sync again
“Sync stuck” #
- Check your internet connection
- Try Sync > Disconnect then Sync > Connect
- Restart AccountsPlus