Linux, MacOS

When deploying using .NET Core on a Linux distribution, or on MacOS, you have to make sure that libgdiplus is installed.

There are several ways to install libgdiplus depending on the distribution. If using apt-get, this is the preferred installation script:

sudo apt-get update && apt-get install -y apt-utils
sudo apt-get install -y libfontconfig1
sudo apt-get install -y libgdiplus

We also recommend the installation of Microsoft's fonts:

sudo apt-get update; apt-get install -y ttf-mscorefonts-installer fontconfig

Starting with Wisej.NET 4, the use of libgdiplus is no longer necessary. This change is due to the development of a new managed System.Drawing library, which has been created in conjunction with ImageSharp.

In case the scripts fail, please search online on how to install libgdiplus and microsoft fonts on Linux or MacOS, and contact our support if you have a different solution.

You will need to manually add the Web.Config file to the publish directory. In Linux builds, the purpose of the Web.Config file is to provide the server key and the initial theme.

In recent version of RHEL based Linux distributions, (e.g. CentOS), the SHA1 encryption scheme was deprecated, and that could lead to issues with activating the server license.

To fix this issue, you'll need to run the following command update-crypto-policies --set LEGACY.

Note: The Linux distribution used in this tutorial video is Ubuntu 22.04.2 LTS. You can get information about which Linux distribution you are using by running the command lsb_release -a