How to fix agent connection issues

Written by Yelena V ( Updated on August 19th, 2026 )

Updated on August 19th, 2026

If you see “Agent disconnected” in Multilogin, it means the web interface can’t reach the agent running on your computer.

In most cases, this is fixed in one of two ways:

reconnecting or reinstalling the agent, or
allowing your browser to communicate with it

Start here:

➡️ Open Multilogin → click “Agent disconnected” → download and install the agent → click “Connect agent”.

If it still shows as disconnected, continue with the browser permission checks below.

Using Multilogin desktop app? You don’t need to connect the agent separately – the desktop app already includes it.

Allow browser access to the agent

Multilogin web interface needs to talk to the agent running on your computer.

Your browser can block this connection. If the agent is installed but still shows as disconnected, check these permissions first.

Chrome

This applies to Chrome, Brave, Edge, Opera, Vivaldi, and Arc.

Open Multilogin dashboard in the browser and if you see the permission request, allow it.

If you’ve already blocked it or want to check it manually:

Click the site controls icon to the left of the address bar
Click “Site settings”
Find “Apps on device” and “Local network” and set both to “Allow”
Return to Multilogin and refresh the page
Try connecting the agent again

Not seeing these settings? Do this:

Go to chrome://flags/#local-network-access-check
Enable “Local Network Access Checks”
Restart your browser
Return to Multilogin and refresh the page
Try connecting the agent again

Firefox

This applies to Firefox, LibreWolf, Zen Browser, Floorp, and Waterfox.

Open Multilogin dashboard in the browser and if you see the permission request, allow it.

If you’ve already blocked it or want to check it manually:

Open Firefox “Settings”
Go to “Permissions and data”
Click “Device apps and services”
Find app.multilogin.com and allow access
Do the same for the setting called “Local network devices”
Return to Multilogin and refresh the page
Try connecting the agent again

Still disconnected? Do this:

Enter about:config in the Firefox address bar
Click “Accept the Risk and Continue”
Search for localnetwork
Click “+” and set the value to “true”
Return to Multilogin and refresh the page
Try connecting the agent again

Yandex

Open Multilogin dashboard in the browser and if you see the permission request, allow it.

If you’ve already blocked it or want to check it manually:

Open Yandex “Settings”
Go to “Websites”
Click “Advanced site settings”
Find “Access to local network” and click “Site settings”
Open the “Allowed” tab and click “Add”
Enter https://app.multilogin.com/ and confirm the change
Do the same for the setting called “Access to apps on this device”
Return to Multilogin and refresh the page
Try connecting the agent again

macOS

On macOS, the system itself can also block local network access.

Check your browser permissions first, then:

Open “System Settings”
Go to “Privacy & Security” → “Local Network”
Enable access for your browser
Enable access for Multilogin
Restart your browser and Multilogin
Try connecting again

Check system requirements

System specs

Multilogin doesn’t support older operating systems like: macOS versions before So

Multilogin doesn’t support older operating systems like:

macOS versions before Sonoma 14
Windows versions before 10
Linux versions before Ubuntu 22

What to do:

Make sure your system meets the minimum requirements. You can quickly check the hardware and software specs in the article Will Multilogin X work on your device? Stay updated to avoid compatibility issues!

If you're using Windows, consider running the agent as an administrator.

Sync system timezone

Timezone

If your system timezone isn’t syncing properly, just follow these steps to get it

If your device time or timezone is out of sync, it can cause connection or session issues.

Before you start, log out of Multilogin. Then close the Multilogin desktop app or disconnect the agent if you use the web interface.

Windows

Click “Start” → “Settings”
Go to “Time & language” → “Date & time”
Enable “Set time zone automatically” and “Set time automatically”
Click “Sync now”

Can’t enable “Set time zone automatically”? Turn on location services:

Go to “Settings” → “Privacy & security” → “Location”
Enable “Location services”
Enable “Let apps access your location”

macOS

Go to “System Settings” → “General”
Choose the “Date & Time” section
Enable the “Set time and date automatically” and “Set time zone automatically using your current location” settings

Can’t enable automatic timezone detection? Turn on location services:

Go to “System settings” → “Privacy & Security”
Pick “Location services”
Turn on this feature for Multilogin

Refresh app components

Deps

This action is completely safe! It refreshes the app components needed for Multil

This action is completely safe. It refreshes the app components needed for Multilogin to work smoothly. No data will be lost during the process, so you're good to go 😊

Avoid deleting the mlx folder, as this may result in a complete or partial data loss.

The deps folder stores local components Multilogin needs to start profiles. Multilogin downloads the required components again after the folder is refreshed.

Close the desktop app 🖥️ or disconnect the agent if you're using the web interface 🌐
Go to the mlx folder:
1. Windows: C:\Users\%username%\mlx
2. macOS: /Users/%username%/mlx
3. Linux: /home/%username%/mlx
Delete the deps folder
Reopen the desktop app 🖥️ or reconnect the agent for the web interface 🌐
Start any profile – this will automatically kick off the components download process

Check third-party apps

Multilogin agent has been thoroughly certified and verified as safe and trustworthy. Sometimes, though, antivirus or firewall software can mistakenly flag legitimate apps like this as threats – but we promise it’s not malicious.

How to fix it:

Disable or whitelist the agent in your antivirus or firewall settings
Turn off VPNs or proxy tools like Proxifier and SocksEscort, as they may block Multilogin connections

Learn more in the article How to fix Multilogin issues caused by antivirus, VPNs, and more.

Check the ISP

ISP

Sometimes, internet service providers (ISPs) block proxy providers or even Multil

Sometimes, internet service providers (ISPs) block proxy providers or even Multilogin itself. Here’s how to test and work around it:

Try connecting through a VPN: this can bypass ISP restrictions
Switch networks: use a different Wi-Fi, or turn your phone into a hotspot with mobile data
Check your speed: if your current ISP is slow, changing networks might also improve performance.

If the issue resolves with these steps, it’s likely your ISP causing the trouble.

Check the browser

Still having issues? Try this:

Update your browser: if the connection works in another browser or incognito, update your original browser to the latest version
Switch browsers or use incognito mode: connect the agent through a different browser or open your current browser in incognito mode
Check for interfering extensions: review your browser extensions and disable any that might block or disrupt your network connections

Stop agent and launcher processes

Sometimes an old agent or launcher process gets stuck in the background.

Open:
1. Task Manager on Windows
2. Activity Monitor on macOS
3. System Monitor on Linux
Find the Multilogin agent and launcher processes and stop them
Then reopen Multilogin and try again

Windows

macOS

Linux

Delete .lock files

.lock files

.lock files are temporary files apps make to show a file or resource is in use. H

.lock files are temporary files apps make to show a file or resource is in use. Here's why you can delete them:

Fix stuck apps: if an app crashes, leftover .lock files can trick the system into thinking it’s still running
Stop errors: these files might block your app from starting or working properly
Clear update problems: if an update or sync gets interrupted, .lock files can block future attempts

Deleting .lock files is like hitting reset – it clears up the mess and lets your app run smoothly again!

Windows

Stop all running profiles
Close the desktop app 🖥️ or disconnect the agent if you're using the web interface 🌐
Go to the mlx folder in your user folder: C:\Users\%username%\mlx
Delete all the .lock files

macOS

Stop all running profiles
Close the desktop app 🖥️ or disconnect the agent if you're using the web interface 🌐
Go to the mlx folder in your user folder: /Users/%username%/mlx
Delete all the .lock files

Check the ports

The agent starts with port 45000. If that port is already busy, it can try the next available port.

Windows

Open the Command prompt (press Win + R, type cmd, and press Enter)
Run the command netstat -ano | findstr :45000

netstat -ano | findstr :45000

Find the PID (Process ID) associated with the processes running on port 45000

If this command doesn't return any processes, it means the port is not in use and the issue is caused by something else. Skip to the next step.

To terminate a process, run the command taskkill /F /PID {PID of the process}

taskkill /F /PID {PID}

Make sure to replace "{PID of the process}" with the actual PID you got in step 3. Repeat the steps for ports 45001, 45002, etc, if needed.

macOS and Linux

Open the Terminal
1. macOS: Press Command + Space, type "Terminal", and press Enter
2. Linux: Press Ctrl + Alt + T
Run the command lsof -i :45000

lsof -i :45000

Look for the PID (Process ID) associated with the processes you want to terminate.

If this command doesn't return any processes, it means the port is not in use and the issue is caused by something else. Skip to the next step.

To terminate a process, run the command kill -9 {PID of the process}

kill -9 {PID of the process}

Make sure to replace "{PID of the process}" with the actual PID you obtained in step 3. Repeat the steps for ports 45001, 45002, etc, if needed.

Restart the device

Sometimes, a fresh start works wonders.

If the steps above didn't do the trick, try giving your device a quick restart and then go ahead with the agent connection steps again.

Nothing helps?

Send us your logs and we’ll take a closer look.

Logs

Recreate the issue or prompt the error message Archive the logs folder located in

Recreate the issue or wait until the error message appears
Archive the logs folder found in these locations:
1. Windows: C:\Users\%username%\mlx
2. macOS: /Users/%username%/mlx
3. Linux: /home/%username%/mlx
Email support at [email protected] with:
1. A clear description of the issue
2. The archived logs folder attached

Common issues

How to fix agent connection issues

Allow browser access to the agent

Chrome

Firefox

Yandex

macOS

Check system requirements

System specs

Sync system timezone

Timezone

Windows

macOS

Refresh app components

Deps

Check third-party apps

Check the ISP

ISP

Check the browser

Stop agent and launcher processes

Windows

macOS

Linux

Delete .lock files

.lock files

Windows

macOS

Check the ports

Windows

macOS and Linux

Restart the device

Nothing helps?

Logs

Related articles