Application does not start

This page lists common causes for Substance 3D Designer failing to start correctly, and offers troubleshooting steps for each.


Windows 10/11

(error) Issue

Substance 3D Designer fails to start on systems using Windows 10 or Windows 11.


(tick) Recommended steps

Older versions of Designer may fail to start on Windows 10 or Windows 11 because of an outdated libeay32.dll library used in the license validation process.

You may try to replace the library with an updated version, such as the one distributed here (select the file for 32-bit Windows), by following these steps:

  1. Locate the libeay32.dll file in Designer's installation directory
  2. Back up the file in a safe location if you need to restore it in the future
  3. Replace the file by the updated version
  4. Start Designer

Please note versions of Designer that are out of their maintenance period are not supported. These versions may not run reliably anymore if significant changes are done to the system, such as OS upgrades.


Windows 7/8/8.1

(error) Issue

Substance 3D Designer fails to start on systems using Windows 7, Windows 8 or Windows 8.1.


(tick) Recommended steps

As part of the version 11.3.0 update, we upgraded multiple librairies, tools and SDKs which broke compatibility with versions of Windows lower than Windows 10.

We strongly recommend upgrading to Windows 10, as Microsoft itself does not support previous versions of Windows anymore for mainstream use (see here and here). Thus, the continued use of these versions presents a security issue.
If upgrading to Windows 10 is not possible, do not update your installation of Designer past version 11.2.2.

Please note Windows 7, Windows 8 and Windows 8.1 are not officially supported. You can learn more on the System requirements page.


Linux

Note to Linux users

Linux users are a pillar of our community and are often the ones who are pushing the limits of what Substance 3D applications can do, pushing us in turn to go above and beyond.
We are aware of the current limitations in supporting popular distributions of Linux, we can and will do better.
Thank you for placing your trust in us!

All distributions

(error) Issue

Substance 3D Designer fails to start.


(tick) Recommended steps

Use this command at Designer's installation directory, replacing %command% with your command to run Designer:

LD_PRELOAD=./plugins/pythonsdk/lib/python3.7/lib-dynload/libffi.so.6 %command%

(error) Issue

The Steam edition of Designer fails to start with and produces no error message.


(tick) Recommended steps

You can acquire error messages by logging the Steam application instead.

As recommended here, completely close Steam then run the following command from a terminal (or create a shortcut for this command):

steam 2>&1 | tee /path/to/logfile

(error) Issue

xcb plugin cannot be loaded. The following message is displayed in the command line:

qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found.
This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.

Available platform plugins are: minimal, offscreen, xcb.

Aborted (core dumped)

(tick) Recommended steps

Some required packages are missing. Run the following command from Designer's installation directory :

ldd libQt5XcbQpa.so.5

Check the printed list for any packages reported as not found, then run the following command for each of these missing packages:

apt-get install <package-name>

E.g.

apt-get install libxcb-xinput0

CentOS 8/RHEL

(error) Issue

Versions 11.1.0 and above of Substance 3D Designer fail to start on the CentOS 8/RHEL distributions of Linux.


(tick) Recommended steps

Remove the libcrypto.so.1.1 file from Designer's installation directory.

Please note the CentOS 8/RHEL distributions of Linux are not officially supported. You can learn more on the System requirements page.

Arch-based distributions

(error) Issue

Substance 3D Designer fails to start on systems using the Arch-based distribution of Linux.


(tick) Recommended steps ((warning) Unstable, AMD GPUs only!)

Try installing progl (part of the AMDGPU-PRO drivers) and start Designer through it. You may do this by using the progl prefix in the application launch command:

progl <designer-application-path>

Be mindful that progl may be unstable. This should therefore be attempted as a last resort.

Please note Arch-based distributions of Linux are not officially supported. You can learn more on the System requirements page.