- Home
- Main Features
- Agent and Launcher Connection
- How to Connect Agent in Multilogin
How to Connect an Agent in Multilogin
Author Yelena V (Updated on May 21, 2026)
Updated on May 21, 2026
After logging into your account for the first time, the system will prompt you to download, install, and connect the Agent. It is a lightweight desktop application that runs in the background and can launch browser profiles.
Please note, even if you do not connect the Agent, you can still manage team members, groups, and browser profiles (create, clone, and move them). But to actually launch a profile, you need to start and run the Agent!
Agent Connection for Regular Users
If you are not a professional who needs to use 'headless' mode, then the following simple steps will allow you to connect immediately. Just choose your operating system and follow the guide to set it up!
Windows
- Click the 'Agent Disconnected' in the top right corner
- Download the Agent for Windows (this ensures you get the latest version with all updates)
- Right-click the file you just downloaded and select 'Run as administrator'
- Follow the on-screen steps to complete the installation
- Click 'Connect Agent' and wait for Multilogin to complete all settings (this may take longer if your internet speed is slow)
macOS
- Click the 'Agent Disconnected' button in the top right corner
- Make sure your operating system is version 14 (Sonoma) or higher
- For M1-M4 chips, select 'M Series'; for other models, select 'Intel', and then download the macOS version of the Agent (this ensures you get the latest version with all updates)
- Click the downloaded file to open the installer
- Follow the on-screen steps to complete the installation
- Click 'Connect Agent' and wait for Multilogin to complete all settings (it may take longer if your internet speed is slow)
Linux
- Click the "Agent Disconnected" in the top right corner
- Download the Linux version of the Agent (this ensures you get the latest version with all updates)
- Right-click the downloaded file and select "Run as Administrator"
- Follow the on-screen steps to complete the installation
- Click "Connect Global IP" and wait for Multilogin to complete all setups (this may take longer if your internet speed is slow)
Agent Connections for Advanced Users
Are you more inclined towards the technical side and want to integrate Agent connections into your automation workflow? These instructions are exactly what you need – dive in and operate like a professional!
Manual Connection
Once installed, the Agent will start by default and connect automatically. If needed, you can also start it by visiting this link in your browser: mlx://start?port=45000. Find the location of the executable file in the path below.
Windows
File Name: agent.exe
File Location: C:Users%username%AppDataLocalMultiloginagent.exe
Command: "C:Users%username%AppDataLocalMultiloginagent.exe"
"C:Users%username%AppDataLocalMultiloginagent.exe"
macOS
File name: Multilogin.app
File location: Applications folder
Command: open -a Multilogin.app
open -a Multilogin.app
Linux
File name: mlx File location: Application list Command: mlx
mlx
Auto Connect
You can set the Agent to start automatically every time the device restarts. Use the Task Scheduler on Windows or the script provided in the article 'How to Automatically Start the Agent'.
Connection under Linux headless
Below is an introduction on how to install and run the Multilogin Agent program on a Linux headless system:
- Download the latest Agent version: curl -L -f -o mlxdeb.deb "https://mlxdists.s3.eu-west-3.amazonaws.org/mlx/latest/Multilogin-amd64.deb"
curl -L -f -o mlxdeb.deb "https://mlxdists.s3.eu-west-3.amazonaws.org/mlx/latest/Multilogin-amd64.deb"
- Extract the contents of mlxdeb.deb into the mlx directory: sudo dpkg-deb -x mlxdeb.deb mlx
sudo dpkg-deb -x mlxdeb.deb mlx
- Extract the control files of mlxdeb.deb into the DEBIAN directory: sudo dpkg-deb –control mlxdeb.deb
sudo dpkg-deb --control mlxdeb.deb
- Install the .deb package: sudo dpkg -i mlxdeb.deb
sudo dpkg -i mlxdeb.deb
- Start the virtual display server in the background: Xvfb :99 -screen 0 1920x1080x24 &
Xvfb :99 -screen 0 1920x1080x24 &
- Run the Agent: mlx &
mlx &
How to Troubleshoot Agent Connection Issues
Unable to connect? This is easy to fix! Check out these guides, or contact our support staff for immediate assistance.
- How to fix Agent connection issues
- How to fix Multilogin issues on macOS
In this article
- Agent connection for regular users
- Agent connection for advanced users
- How to troubleshoot Agent connection issues
Multilogin Community
Stay informed, share your thoughts, and interact with others!
Read more related content
Related Articles
- How to uninstall an Agent in Multilogin
- How to manage Agent logs in Multilogin
- How to check and update the Agent version in Multilogin
- How the Agent and launcher work together in Multilogin