Home Getting Started with SoapUI Installing SoapUI Installing on Mac

Installing SoapUI on Mac

1. Installing on Mac

Once you've downloaded the installer the installation is pretty straight forward. Start it by just double-clicking on it. After preparing the installation which takes only a few seconds you'll see the starting screen:

Installing SoapUI on macOS: Welcome to Setup Wizard

Click Next to continue.

Select the destination folder which by default is set to /Applications.

Installing SoapUI on macOS: Select destination directory

Next step gives you opportunity to optionally include, as additional components, SoapUI source files, tutorials and HermesJMS installation.

Installing SoapUI on macOS: Select components

Note: If you choose to install HermesJMS, you will have to accept the HermesJMS license agreement.

If you choose to install SoapUI tutorials, specify the directory to which you want to install them:

Installing SoapUI on macOS: Install tutorials

After that a window appears where you'll be asked to select if desktop icon should be created. Starting from version SoapUI 3.6-beta2 JxBrowser is working on mac, but there is still a issue left with  browser being always displayed on top if opened.

Installing SoapUI on macOS: Creating desktop icon

Finally, by clicking Next, the installation starts

Installing SoapUI on macOS: Extracting files

After couple of minutes most the installation should be finished and you should see the next screen:
Installing SoapUI on macOS: Finishing installation

Now you are ready to use it. Good luck!

2. Installation problems

If your installed SoapUI instance on a Mac is not responding, try the following steps to resolve the issue:

  1. In soapui-settings.xml file add or update the following line:
    <con:setting id="UISettings@disable-browser">true</con:setting>
  2. If that doesn't work, start ReadyAPI with the following parameter added to the command line:
    -Dsoapui.jxbrowser.disable=true
  3. Alternatively, you can navigate to SoapUI*.app and do "Show Package Info" ( from popup menu ).
    Then you should see Contents directory. Open Info.plist file for editing where you can add:
    <key>soapui.jxbrowser.disable</key>
    <string>true</string>
  4. We have also seen some issues with SoapUI installs in Mac when GateKeeper is active. So to rule out that possible conflict, deactivate GateKeeper and try starting SoapUI

Also if you want to change the look and feel of SoapUI or ReadyAPI to look more like a Mac application, change the following settings:

  1. Go to File > Preferences > UI Settings tab
  2. Check "Use native look & feel"
  3. Restart ReadyAPI

Install from zip file

To install from zip file, you need the zip file version:

  • Click Mac OS X (Java not included) to download it
  • Unpack the downloaded zip (if it is not done automatically)
  • Open the SoapUI directory
  • Open the bin directory
  • Find the soapui.sh file

  • Rename the file to soapui.command

  • Double-click the soapui.command fil to run SoapUI

Install Java

Most likely you want to use the zip file because you already have a Java distribution installed.

If that is not the case, you will be asked to install Java:

  • Click Install

You will have to accept the license agreement:

  • Click Agree

The Java packages is downloaded:

After download, the install starts automatically:

When the install is finished, you can close the installer:

  • Click OK

No one knows APIs better than SmartBear. Find out what our Pro version of SoapUI can do to improve your testing.