Skip to content

Troubleshooting WSO2 Integration Studio

The following are some of the ways to troubleshoot errors that you may encounter when working with WSO2 Integration Studio.

Adding an artifact

Once you add an artifact, you need to refresh the CompositeApplication.pom file to reflect new changes on the Composite Application.


Restoring the project perspective

If your project view goes missing, you can get it back by navigating to Window -> Perspective -> Reset Perspective from the toolbar.

Opening a project view

If you need to open a particular project view, you can get it by navigating to Window -> Show View -> Other... from the toolbar, and open the preferred view from the list.

Unable to drag and drop mediators into the canvas

When you use display scaling that exceed 150% (in Windows or Linux environments only), you may observe that you cannot drag and drop mediators into the canvas. To overcome this issue, add the following line (VM argument) to the IntegrationStudio.ini file in the installation directory of WSO2 Integration Studio.


Be sure to add this as the last line in the file.


Error creating Docker image (on MacOS)

When you run WSO2 Integration Studio on MacOS, you will sometimes get the following error when you generate a Docker image of your integration artifacts: "Error creating Docker image".

The details of the error are given below. To access WSO2 Integration Studio errors, see the instructions on viewing the WSO2 Integration Studio error log

org.wso2.developerstudio.eclipse.esb.docker.exceptions.DockerImageGenerationException: Could not create the Docker image bundle file.
at org.wso2.developerstudio.eclipse.esb.docker.util.DockerImageGenerator.buildImage(
at org.wso2.developerstudio.eclipse.esb.docker.util.DockerImageGenerator.generateDockerImage(
Caused by: com.spotify.docker.client.exceptions.DockerException: Cannot run program “docker-credential-osxkeychain”: error=2, No such file or directory
at com.spotify.docker.client.auth.ConfigFileRegistryAuthSupplier.authForBuild(
at org.wso2.developerstudio.eclipse.esb.docker.util.DockerImageGenerator.buildImage(
… 3 more
Caused by: Cannot run program “docker-credential-osxkeychain”: error=2, No such file or directory
at java.lang.ProcessBuilder.start(
at java.lang.Runtime.exec(
at java.lang.Runtime.exec(
at java.lang.Runtime.exec(
at com.spotify.docker.client.SystemCredentialHelperDelegate.exec(
at com.spotify.docker.client.SystemCredentialHelperDelegate.get(
at com.spotify.docker.client.DockerCredentialHelper.get(
at com.spotify.docker.client.DockerConfigReader.authWithCredentialHelper(
at com.spotify.docker.client.DockerConfigReader.authForAllRegistries(
at com.spotify.docker.client.auth.ConfigFileRegistryAuthSupplier.authForBuild(
… 6 more
Caused by: error=2, No such file or directory
at java.lang.UNIXProcess.forkAndExec(Native Method)
at java.lang.UNIXProcess.<init>(
at java.lang.ProcessImpl.start(
at java.lang.ProcessBuilder.start(
… 15 more

This error is because the Docker UI installation on your MacOs has a feature that stores Docker credentials on Mac Keychain. To fix this, you must disable this feature from the Docker UI. Also, this will automatically be saved in your ~/.docker/config.json file.

docker ui

Error creating Docker image (on Windows)

When you build a Docker image either via Docker Exporter Project or Kubernetes Exporter Project in WSO2 Integration Studio on Windows, you may sometimes get the following error: "Docker image generation failed".

The details of the error are given below. To access WSO2 Integration Studio errors, see the instructions on viewing the WSO2 Integration Studio error log

[WARNING] An attempt failed, will retry 1 more times
org.apache.maven.plugin.MojoExecutionException: Could not build image
at com.spotify.plugin.dockerfile.BuildMojo.buildImage(
at com.spotify.plugin.dockerfile.BuildMojo.execute(
at com.spotify.plugin.dockerfile.AbstractDockerMojo.tryExecute(
at com.spotify.plugin.dockerfile.AbstractDockerMojo.execute(
at org.apache.maven.plugin.DefaultBuildPluginManager.executeMojo(
at org.apache.maven.lifecycle.internal.MojoExecutor.execute(
at org.apache.maven.lifecycle.internal.MojoExecutor.execute(
at org.apache.maven.lifecycle.internal.MojoExecutor.execute(
at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject(
at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject(
Caused by: Connect to localhost:2375 [localhost/, localhost/0:0:0:0:0:0:0:1] failed: Connection refused: connect
... 21 more
Caused by: Connection refused: connect
at Method)

To overcome this issue, you must go to the Docker Desktop settings in Windows and expose the daemon on TCP without TLS .

Follow the steps given below.

  1. Right-click the Docker icon in the Notifications area (or System tray) to open the Docker Desktop menu.
  2. Select Settings.

    Docker Desktop menu

  3. In the Settings dialog box that opens, select Expose daemon on tcp without TLS.

    Docker settings tab

  4. Restart Docker to apply the changes.

Getting Started page goes blank

The Getting Started page of WSO2 Integration Studio goes blank on some occasions when using older Firefox browser versions like 59.0. Upgrade to a newer version of Firefox (for example, 77.0.1) to fix the problem and have a seamless experience when using this page.

View WSO2 Integration Studio Error Log

To get details of a WSO2 Integration Studio error:

  1. Select the WSO2 Integration Studio window that you have open.
  2. Go to Windows -> Show View -> Other on the top menu bar of your computer and select Error Logs.

    This will open the Error Log tab in WSO2 Integration Studio:

    error log tab

  3. Double-click the required error to see the details.