Skip to main content

Troubleshooting built-in startup issues

This guide helps you resolve common security-related errors when launching Platforma in built-in backend mode on macOS and Windows.

Updated over 8 months ago

macOS: "OS security is preventing Platforma from starting"

If you are encountering the error message, “Your OS security is preventing Platforma from starting. To grant it the necessary permissions, please run the application as an administrator” when trying to launch Platforma.bio on your macOS device, this guide will help you resolve it.
​

This error typically occurs because macOS's security features have placed the Platforma application in "quarantine," preventing it from running correctly, even if your security settings appear to be correct.
​

Step 1: Verify Your Security & Privacy Settings

First, ensure that your Mac is set up to allow applications from identified developers.

  1. Open System Settings.

  2. Navigate to Privacy & Security.

  3. Scroll down to the "Security" section.

  4. Ensure that "App Store and identified developers" is selected under "Allow applications downloaded from:".

If you had to change this setting, please try launching Platforma.bio again. If the error persists, proceed to the next step.

Step 2: Remove the Quarantine Flag Using Terminal

If your security settings are correct, the issue is likely that the core component of Platforma has been quarantined by the operating system. You can resolve this by manually removing the quarantine flag using the Terminal application.

  1. Open the Terminal app. You can find it in your Applications/Utilities folder, or by searching for it with Spotlight (Cmd + Space).
    ​

  2. First, you need to identify your specific Platforma version folder. Copy and paste the following command into the Terminal and press Enter:

    ls ~/Platforma/local/binaries/

    Note the folder name that starts with pl-, for example, pl-1.35.2-amd64. You will use this exact name in the next steps.

  1. Now, check if the quarantine flag is set. Copy the command below, replace <your-platforma-version-folder> with the name you found in the previous step, and press Enter.

    xattr ~/Platforma/local/binaries/<your-platforma-version-folder>/binaries/platforma

  2. If the previous command returned com.apple.quarantine, it confirms the application is quarantined. To remove the flag, copy the command below, once again replacing <your-platforma-version-folder> with your specific version folder name, and press Enter:

    xattr -d com.apple.quarantine ~/Platforma/local/binaries/<your-platforma-version-folder>/binaries/platforma

  3. Once the command has been executed, close the Terminal and try launching Platforma.bio again. The application should now start without the security error.

Windows: "spawn EPERM" error and other errors when starting Built-In mode

When using the Built-in backend on Windows, you might encounter a "spawn EPERM" error and other errors depending on your environment. This error indicates that Platforma.bio does not have sufficient permissions to run its backend process. This can be caused by Windows security settings or by antivirus software.
​

Step 1: Run as Administrator

The most common solution is to run Platforma.bio with administrative privileges.

  1. Right-click on the Platforma.bio application icon.

  2. Select "Run as administrator" from the context menu.

If this resolves the issue, you can configure the application to always run as an administrator:

  1. Right-click the application icon and select Properties.

  2. Go to the Compatibility tab.

  3. Check the box for "Run this program as an administrator".

  4. Click Apply and then OK.

Step 2: Check Antivirus Software

If running as an administrator does not solve the problem, your antivirus software might be blocking Platforma.bio from executing.

  1. Open your antivirus software's settings.

  2. Look for a section related to "Blocked Applications," "Quarantine," or "Exclusions."

  3. Check if platforma.exe or any related files are listed as blocked.

  4. If you find any, add Platforma.bio and its installation directory to your antivirus software's "allow list" or "exclusion list." The exact steps will vary depending on your antivirus program.

If you continue to experience issues after following these steps, please don't hesitate to contact our support team for further assistance.

Step 3: Check network availability

Platforma application requires network connection with the licensing server. Run the ping command to check it.

  1. Click "Start" button.

  2. Type "cmd", you will see "Command Prompt in "Best match" section. Click it.

  3. In black window opened type and press Enter:
    ​ping licensing-api.milaboratories.com

  4. If you see something like following, then all works fine

    Pinging licensing-api.milaboratories.com [75.2.96.100] with 32 bytes of data:

    Reply from 75.2.96.100: bytes=32 time=10ms TTL=246
    Reply from 75.2.96.100: bytes=32 time=13ms TTL=246
    Reply from 75.2.96.100: bytes=32 time=10ms TTL=246
    Reply from 75.2.96.100: bytes=32 time=11ms TTL=246

    Ping statistics for 75.2.96.100:    Packets: Sent = 4, Received = 4, Lost = 0 (0% loss)

  5. If you see that some packages lost, please check the internet connection or ask your System Administrator.

Did this answer your question?