Do you have issues with starting browser profiles on a Linux server? Do you have any issues when retrieving a port number after a successful API response? Do you get an error when you try enabling automation type and headless mode? This article will get you covered!

Launch profiles manually

1. Launch Terminal
2. Run the following command (replace folder_id and profile_id respectively):

   curl -X GET https://localhost:45000/api/v2/profile/f/<folder_id>/p/<profile_id>/start

3. Check if the profile launches successfully

Locate and analyze agent logs

1. Go to one of the following directories:
   1. /opt/usr/mlx/
   2. /home/%username%/mlx/logs
2. Look for launcher_<date>.log and agent_<date>.log

Investigate SSL/TLS errors

1. Check for “Bad record MAC” errors in the logs: SSL: DECRYPTION_FAILED_OR_BAD_RECORD_MAC
2. Make sure that the Linux server's OpenSSL configuration is correct

Compare API and UI behavior

1. If launching via the UI works, but API fails, check API parameters and UI settings (they should match)
2. Test using the same profile ID and settings manually via curl

Check Linux environment setup

1. Make sure that Xvfb is installed and properly configured for headless mode. Refer to the following articles for more details: 
   1.  How to connect the agent in Multilogin X (connection on Linux headless)
   2. Configure the agent for headless mode and auto-launch in Linux
2. Confirm that the Multilogin X agent or app is running and accessible via the correct port (refer to the step from the following article: How to fix agent connection issues)

Nothing works?

If the issue persists, send us your log files, and we will investigate it further for you.

1. Recreate the issue or wait until the error message appears
2. Archive the logs folder found in this location:
   /home/%username%/mlx
3. Email support at [email protected] with:
   1. A clear description of the issue
   2. The archived logs folder attached