Skip to main content

Installation as a Desktop Application for Linux

Compatibility

CODESYS 4 on Linux is officially supported only for Debian at this time. It is possible that the package can also be made to run on other Debian-based distributions, such as Ubuntu, Kubuntu, etc. However, support for this can only be offered to a limited degree.

Runtime and gateway

The Linux packages from CODESYS 4 do not currently include a CODESYS Gateway or a CODESYS Runtime.

You can find the corresponding downloads in the CODESYS Store.

Requirement: Installation of the .NET runtime

CODESYS 4 requires ASP.NET Core Runtime version 8 (latest patch level). The CODESYS 4 installation requires the latest version of the aspnetcore-runtime-8.0 package.

Microsoft provides a package for amd64 (x86-64) platforms running Debian Linux 12. It is recommended to set up the respective package source: https://learn.microsoft.com/en-us/dotnet/core/install/linux-debian?tabs=dotnet8.

There is currently no ready-made Debian package for arm64 platforms. However, Microsoft does provide an installation script as well as a guide for manual installation: https://learn.microsoft.com/en-us/dotnet/core/install/linux-scripted-manual

For Ubuntu, there are packages for amd64 and arm64. These should also work, but we are not currently testing them. For more information, see the following: https://launchpad.net/ubuntu/questing/+package/aspnetcore-runtime-8.0

For operation in containers, Microsoft provides base images with a pre-installed runtime. For more information, see the following: https://hub.docker.com/r/microsoft/dotnet and https://github.com/dotnet/dotnet-docker/blob/main/README.aspnet.md. The corresponding Debian-based images should work here with ASP.NET Core Runtime 8. Then you use a Dockerfile to install the Debian package into these images.

Note

Running in emulators such as QEMU – also implicitly via Docker Multi-Platform – is currently not supported by .NET.

Installing the Debian package

Download the Debian package to a folder on the target computer and install it from the package manager:

$> sudo dpkg -i /c/Users/<user name>/Downloads/codesys-4_0.0.1.0_amd64.deb

Usage as a CLI command and desktop application

After the installation, you can use CODESYS 4 as a CLI application, for example with the following call:

$> c4-cli library save-compiled Documents/CompiledLibTest/GoCompiledTestLib.fbslib/ ./Test.compiled-library

The CLI command c4-cli --help will give you information about available commands.

You can launch the interface in your default browser, as long as a graphical interface is active:

$> c4-cli standalone-session

You can use the --with-browser option to specify a different browser.