How to Resolve Notion ‘Cannot Connect to Database’ Error on First Open
🔍 WiseChecker

How to Resolve Notion ‘Cannot Connect to Database’ Error on First Open

When you first open Notion, the app may display a “Cannot Connect to Database” error instead of loading your workspace. This error typically occurs because Notion cannot reach its cloud servers due to a local network restriction, a corrupted local cache, or an outdated app version. This article explains the root causes of this connection failure and provides four tested methods to restore access. You will learn how to clear the app cache, check your firewall settings, and reinstall Notion without losing your data.

Key Takeaways: Fixing the Notion Database Connection Error

  • Notion Desktop Cache Folder: Deleting the %AppData%\Notion\Cache folder removes corrupted data that blocks the initial connection.
  • Windows Defender Firewall Outbound Rule: Creating an outbound allow rule for notion.exe prevents the firewall from blocking Notion’s server communication.
  • Notion Web Version as Fallback: Using notion.so in a browser bypasses the desktop app entirely and confirms if the issue is local or server-side.

ADVERTISEMENT

Why Notion Shows “Cannot Connect to Database” on First Open

The “Cannot Connect to Database” error appears when the Notion desktop app fails to establish a secure HTTPS connection to Notion’s backend servers. On the first open, the app must download your workspace data from the cloud. If the connection is interrupted at any point, Notion cannot load the database that stores your pages, databases, and settings.

Three factors commonly cause this failure:

Corrupted Local Cache

Notion stores a local copy of your workspace data in a cache folder. If this cache becomes corrupted due to an incomplete previous sync or a disk write error, the app may refuse to connect. The corruption does not affect your data on Notion’s servers, but it blocks the initial handshake between the app and the cloud.

Firewall or Antivirus Blocking Outbound Traffic

Windows Defender Firewall or third-party security software may mistakenly flag Notion’s outbound connection as suspicious. On the first run, the firewall might not have an existing allow rule for notion.exe, so it drops the connection. This results in a timeout that triggers the database connection error.

Outdated App Version

An older version of the Notion desktop app may use a deprecated API endpoint or SSL certificate. If the app was installed a long time ago and never updated, the server may reject the connection. Notion requires the app to be on a recent version to enforce security updates.

Steps to Clear the Notion Cache and Reconnect to the Database

  1. Close Notion completely
    Right-click the Notion icon in the system tray and select “Quit.” Ensure no Notion process is running in Task Manager under the Processes tab.
  2. Open the Windows Run dialog
    Press the Windows key + R on your keyboard. Type %AppData%\Notion and press Enter. This opens the Notion data folder in File Explorer.
  3. Delete the Cache folder
    Inside the Notion folder, locate the subfolder named Cache. Right-click it and select “Delete.” Confirm any prompt that appears. Do not delete any other files or folders in this directory.
  4. Restart Notion
    Open Notion again from the Start menu or desktop shortcut. The app will recreate the cache folder and attempt to download fresh data from the server. The error should no longer appear.

ADVERTISEMENT

If the Error Persists: Check Your Firewall and Network

If clearing the cache does not resolve the issue, a firewall or network restriction is likely blocking Notion. Follow these steps to create an outbound allow rule in Windows Defender Firewall.

  1. Open Windows Defender Firewall with Advanced Security
    Press the Windows key, type wf.msc, and press Enter. This opens the advanced firewall management console.
  2. Create a new outbound rule
    In the left pane, click “Outbound Rules.” In the right pane, click “New Rule.” The New Outbound Rule Wizard opens.
  3. Select Program as the rule type
    Choose the “Program” option and click Next. Then select “This program path.” Click Browse and navigate to C:\Users\[YourUsername]\AppData\Local\Programs\Notion\Notion.exe. Adjust the path if you installed Notion in a custom location. Click Next.
  4. Allow the connection
    Select “Allow the connection” and click Next. Check all three profile boxes: Domain, Private, and Public. Click Next.
  5. Name the rule
    Enter a name such as “Notion Outbound Allow.” Click Finish. Restart Notion and check if the error is gone.

If Notion Still Has Issues After the Main Fix

“Cannot Connect to Database” Appears Only on Desktop but Not on Web

Open a browser and go to notion.so. Log in with your account. If your workspace loads correctly, the problem is isolated to the desktop app. Reinstall Notion by uninstalling it from Settings > Apps > Installed Apps, then download the latest version from the official Notion website. This replaces any corrupted app files that clearing the cache did not fix.

Error Occurs After a Windows Update

A recent Windows update may have changed your network profile from Private to Public, which applies stricter firewall rules. Open Settings > Network & Internet > Wi-Fi or Ethernet. Click your active network and set the network profile to Private. Then repeat the firewall rule creation steps above.

VPN or Proxy Service Interfering with Notion

If you use a VPN or proxy, disconnect it temporarily. Notion requires a direct HTTPS connection to api.notion.com and notion.so. Some VPNs block or reroute these domains. After disconnecting, restart Notion. If the error disappears, add an exception for Notion in your VPN software.

Notion Desktop vs Web: Key Differences for First-Time Connection

Item Notion Desktop App Notion Web Version
Connection method Direct HTTPS to Notion servers HTTPS via browser
Local cache dependency Uses local cache on first open No local cache
Firewall interference High — outbound rule may be missing Low — browser usually has existing rule
Offline access Supports limited offline mode Requires active internet
Update mechanism Manual or auto-update via app Always latest version

The table shows that the desktop app is more prone to connection errors due to its dependency on local cache and firewall rules. The web version is a reliable fallback when troubleshooting.

You can now resolve the “Cannot Connect to Database” error by clearing the cache or adjusting your firewall settings. If the problem reappears after a future update, repeat the cache deletion step first. For ongoing reliability, keep Notion updated by enabling automatic updates in the app’s Preferences menu.

ADVERTISEMENT