Vauz Docs
Vauz Questions
Extension cannot connect to main Vauz app

Cannot Connect to Main App

This error occurs when the Vauz extension's native messaging connection fails, meaning the extension cannot establish a communication port with the main Vauz application. This typically happens when either:

  • The main Vauz application is not installed or not running
  • The native messaging host is not properly registered
  • There are conflicts with existing extension installations

Primary Solution: Complete Reinstallation

The most effective way to resolve connection issues is to completely remove both the main Vauz application and the browser extension, then reinstall them in the correct order

Don't worry about losing your data: All your credentials and passwords are safely stored separately from the main application. Uninstalling Vauz won't delete your vault data. In the rare case you want extra security, you can create a backup of your passwords (this feature is currently in development and not yet publicly available)

Step 1: Uninstall the Main Vauz Application

Step 2: Remove the Browser Extension

Step 3: Restart Your Browser

Close all browser windows completely, then reopen your browser

Step 4: Reinstall the Main Vauz Application

  1. Visit the official Vauz website (opens in a new tab) and download (opens in a new tab) the latest version
  2. Install the application following the on-screen instructions
  3. Launch the Vauz application and complete any initial setup

Step 5: Reinstall the Browser Extension

  1. Visit the official Vauz website (opens in a new tab) or your browser's extension store
  2. Download and install the Vauz Autofill extension for your browser
  3. Complete the registation process to connect to the main Vauz app

Step 6: Verify the Connection

  1. Click on the Vauz Autofill extension icon in your browser toolbar
  2. You should see a connection confirmation or registration prompt
  3. Follow any on-screen instructions to complete the setup

Registration success notification

If the Primary Solution Doesn't Work

If reinstalling doesn't resolve the issue, try these additional steps:

Step 1: Update Your Browser

Ensure you're using the latest version of your browser:

Step 2: Clear Browser Cache and Cookies

Step 3: Restart Your Computer

A full system restart can resolve underlying system conflicts

Step 4: Repeat the Complete Reinstallation

Follow Steps 1-6 from the primary solution above.

Still Having Issues?

If none of the above solutions work, please contact our support team with the following information:

  • Your operating system and version
  • Your browser type and version
  • Steps you've already tried
  • Any error messages you're seeing
  • Whether you're using antivirus software or firewall that might be blocking the connection
Created on January 21, 2026Last updated on February 6, 2026