Problem Overview

Users may encounter a situation where the LedgerSync Desktop App displays "Connecting..." indefinitely and never completes the connection to the web application.

Root Cause

The LedgerSync Desktop App must operate on the same browser as the LedgerSync web application.

Windows automatically defaults to your default browser when launching the Desktop App, regardless of which browser you're currently using to access LedgerSync. This creates a browser mismatch.

Example Scenario

• You're running LedgerSync in Chrome
• Your Windows default browser is set to Edge
• When you launch the LedgerSync Desktop App, Windows opens it in Edge (the default)
• The Desktop App (running in Edge) cannot establish a connection with LedgerSync (running in Chrome)
• Result: The app gets stuck on "Connecting..."

Why This Happens

The LedgerSync Desktop App and the LedgerSync web application need to communicate through the same browser session to establish a secure connection. When they run in different browsers, they cannot establish this connection, causing the indefinite "Connecting..." state.

Solution

Option 1: Use Your Default Browser for Everything

1. Identify your Windows default browser:
   • Close all browsers and the LedgerSync Desktop App
   • Launch the LedgerSync Desktop App
   • Windows will automatically open your default browser
2. Use this browser for LedgerSync:
   • Note which browser opened (this is your default browser)
   • Going forward, always access LedgerSync in this browser
   • The Desktop App will now connect properly

Option 2: Change Your Default Browser

If you prefer to use a different browser (e.g., Chrome instead of Edge):

1. Change Windows default browser settings:
   • Windows 10/11: Settings > Apps > Default apps
   • Search for "Web browser" or "Default apps"
   • Select your preferred browser (Chrome, Edge, Firefox, etc.)
2. Restart everything:
   • Close all browsers
   • Close the LedgerSync Desktop App
   • Open your newly set default browser
   • Navigate to LedgerSync
   • Launch the Desktop App

Option 3: Quick Test Method

To quickly identify which browser to use:

1. Close all browsers and applications
2. Launch the LedgerSync Desktop App only
3. Windows will open your default browser automatically
4. Use that same browser to access LedgerSync going forward

Key Takeaway

Both the LedgerSync web application and the LedgerSync Desktop App must run on the same browser for the connection to work properly.

Additional Technical Details

For more in-depth technical documentation about the LedgerSync Desktop App architecture and requirements, please refer to the technical documentation in Confluence.

Need Help?

If you continue to experience connection issues after ensuring both applications are running on the same browser, please contact LedgerSync Support at support@ledgersync.com with:

• The browser you're using
• Your Windows default browser setting
• A screenshot of the connection status
• Any error messages you're seeing