Help

Common questions and troubleshooting for Bridge Bank.

Syncing
Transactions aren't syncing

A few things to check:

1. Check if your bank session is still active. Go to the Bank page and look for an expiry warning. If expired, click "Re-authorise bank".

2. Some banks have a delay. Open banking transactions can take 1-2 days to appear, even if they show in your bank's app. Try again tomorrow.

3. Check the sync log. Go to the Status page and look at the sync log. If it says "success" with 0 transactions, your bank returned no new transactions for that period.

4. Download your logs from the Status page and send them to support@bridgebank.app if the issue persists.

I'm getting duplicate transactions

Bridge Bank uses transaction IDs and date/amount matching to prevent duplicates. If you're seeing duplicates, it's usually because:

The same transaction appears with different IDs from your bank (e.g. pending vs settled). Bridge Bank tracks pending transactions and updates them when they settle, but some banks handle this differently.

If you reset your sync and re-sync from an earlier date, Bridge Bank will skip transactions already in Actual Budget. Existing transactions won't be duplicated.

I reset the sync date but nothing new came through

When you reset sync, Bridge Bank fetches transactions from the new date but uses reconciliation to avoid duplicates. Transactions already in Actual Budget are matched and skipped.

If you're expecting new transactions that aren't appearing, check that your bank is returning them. Hit "Sync now" on the Status page, then download your logs to see exactly what was fetched.

My bank says "rate limiting"

Some banks limit how often you can request transaction data through open banking. This is normal and temporary. Bridge Bank will automatically retry on the next scheduled sync.

If it keeps happening, try reducing your sync frequency to every 24 hours.

Bank connection
My bank session expired

Bank sessions through open banking typically last 90-180 days. When yours expires, go to the Bank page and click "Re-authorise bank". You'll go through your bank's login again to renew access.

Bridge Bank sends you an email warning when your session is about to expire.

My bank isn't listed

Bridge Bank supports 2,500+ European banks through Enable Banking. If your bank isn't showing up, make sure you've selected the correct country when connecting.

Some banks are only available as "personal" or "business" accounts — try switching the account type.

If your bank still doesn't appear, it may not be supported by Enable Banking yet. You can check their coverage page.

Setup & updates
How do I update Bridge Bank?

Bridge Bank checks for updates automatically every 24 hours and updates itself in the background. You can also click "Check for updates" on the Status page to update immediately.

You can see which version you're running in the footer of any page.

Email notifications aren't working

Go to the Notifications setup page and check your SMTP settings. Use the "Send test email" button to verify your configuration.

Common issues:

Gmail: You need an App Password, not your regular password. Use smtp.gmail.com as the SMTP host.

Outlook/Hotmail: Use smtp-mail.outlook.com as the SMTP host.

iCloud: You need an App-Specific Password from appleid.apple.com. Use smtp.mail.me.com.

Can I connect to Actual Budget over HTTPS?

Yes. In the Actual Budget setup step, enter the full URL including https://. Make sure the SSL certificate is valid and that Bridge Bank can reach the Actual Budget server from the Docker container.

If you're running both on the same machine, you can use the internal Docker IP or host.docker.internal instead of localhost.

License
How many machines can I activate?

Each license can be activated on up to 2 machines. If you need to move your license to a different machine, deactivate it first from the Status page, then re-enter your key on the new machine.

My license says "not activated on this machine"

This happens when the license was activated on a different machine or the activation was reset. Go to the License setup page and re-enter your license key.

If you've reached the activation limit, deactivate from another machine first, or contact support.

Still stuck? Send your logs and a description of the issue to
support@bridgebank.app

You can download your logs from the Status page inside Bridge Bank.