IronBarCode Linux Compatibility & Setup Guide
IronBarcode fully supports Linux for .NET Standard, .NET Core, and .NET Framework applications on a wide variety of distributions.






No code changes are required to run IronBarcode on Linux. Generally speaking, IronBarcode works out of the box thanks to hundreds of hours of testing and configuration by our engineers.
Linux support is important as many of the cloud services today run on Linux. At Iron Software, we use these cloud tools regularly and understand that many of our Enterprise and SaaS customers do too.
Officially Supported Linux Distros
We officially support and recommend the latest 64-bit Linux distributions below for a "zero-configuration" setup of IronBarcode:
- Ubuntu ≥18
- Debian ≥10
- CentOS ≥7
Other Linux distributions are supported in part, but may require additional manual configuration.
Ubuntu Compatibility
Ubuntu is our most tested Linux operating system. This is because it is heavily used in the Azure infrastructure that supports our continuous testing and deployment. This platform also has official Microsoft .NET support and official Docker images available.
Ubuntu 20






Official Microsoft Docker Images:
Ubuntu 20 Setup
To run IronBarcode, first ensure you have sudo admin privileges, then add these commands to your Dockerfile:
# Update package lists
RUN apt update
# Install libgdiplus, a library used for GDI+ support
RUN apt install -y libgdiplus
Ubuntu 18






Official Microsoft Docker Images
Ubuntu 18 Setup
To run IronBarcode, first ensure you have sudo admin privileges, then add these commands to your Dockerfile:
# Update package lists
RUN apt update
# Install libgdiplus, a library used for GDI+ support
RUN apt install -y libgdiplus
Debian 11






Official Microsoft Docker Images
Debian 11 Setup
To run IronBarcode, first ensure you have sudo admin privileges, then add these commands to your Dockerfile:
# Update package lists
RUN apt update
# Install libgdiplus, a library used for GDI+ support
RUN apt install -y libgdiplus
Debian 10






Official Microsoft Docker Images
Debian 10 Setup
To run IronBarcode, first ensure you have sudo admin privileges, then add these commands to your Dockerfile:
# Update package lists
RUN apt update
# Install libgdiplus, a library used for GDI+ support
RUN apt install -y libgdiplus
CentOS
CentOS 7 Setup
To run IronBarcode, first ensure you have sudo admin privileges, then add these commands to your Dockerfile:
# Install EPEL repository for extra packages
RUN yum install epel-release -y
# Install Mono, a cross-platform implementation of .NET
RUN yum install mono-complete -y
# Install libgdiplus and libc6-dev for graphics support
RUN yum install libgdiplus libc6-dev -y
Frequently Asked Questions
Which Linux distributions are officially supported by IronBarcode?
IronBarcode officially supports the latest 64-bit versions of Ubuntu (≥18), Debian (≥10), and CentOS (≥7) for a zero-configuration setup.
Do I need to make code changes to use IronBarcode on Linux?
No code changes are required to run IronBarcode on Linux. It generally works out of the box thanks to extensive testing and configuration.
What are the setup requirements for Ubuntu 20?
To run IronBarcode on Ubuntu 20, ensure you have sudo admin privileges, then update package lists using 'apt update' and install libgdiplus with 'apt install -y libgdiplus'.
How can I set up IronBarcode on Debian 11?
For Debian 11, you need sudo admin privileges. Update package lists with 'apt update' and install libgdiplus using 'apt install -y libgdiplus'.
What additional libraries are required for CentOS 7?
For CentOS 7, you need to install the EPEL repository, Mono, libgdiplus, and libc6-dev. Use the 'yum' package manager for these installations.
Is additional configuration needed for distributions other than Ubuntu, Debian, or CentOS?
Other Linux distributions are supported in part and may require additional manual configuration.
Why is Ubuntu the most tested Linux OS for IronBarcode?
Ubuntu is heavily used in the Azure infrastructure supporting continuous testing and deployment, and it has official Microsoft .NET support and Docker images.
Are there official Docker images available for IronBarcode?
Yes, there are official Microsoft Docker images available for .NET Standard and ASP.NET Core.
What role does libgdiplus play in IronBarcode setup?
Libgdiplus is a library used for GDI+ support, which is necessary for running IronBarcode on Linux systems.
How does IronBarcode benefit cloud services?
Linux support is crucial as many cloud services run on Linux. IronBarcode integrates well with these environments, benefiting Enterprise and SaaS customers.