1. IronBarcode
2. How-Tos
3. Linux

IronBarCode Linux Compatibility & Setup Guide

IronBarCode supports Linux for .NET Core and .NET 5 applications, as well as Docker, Azure, macOS and (naturally) Windows.

We recommend using .NET Core 3.1 or .NET Core 5 and any other runtimes marked as LTS by Microsoft because they have guaranteed long term support and are generally well tested on Linux.

No code changes are required to run on IronBarCode Linux. Generally IronBarCode works out of the box thanks to hundreds of hours of testing and configuration by our engineers.

Linux support is important because many cloud service such as Azure Web Apps, Azure Functions, AWS EC2, AWS Lambda, Azure Devops Docker rely heavily 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 OS's below for "zero configuration" setup of IronBarCode.

• Ubuntu 20
• Ubuntu 18
• Debian 11
• Debian 10 [Currently the Microsoft Azure Default Linux Distro]
• Centos 7

Please Read "Other Linux Distros" below for advice on installing IronBarCode on a version of Linux which is not officially supported.

We recommend using Microsoft's Official Docker Images . Other Linux distros are supported in part, but may require manual configuration using apt-get. See "Linux Manual Setup" at the end of this document.

IronBarCode NuGet Packages

Install-Package BarCode

Ubuntu Compatibility

Ubuntu is our most tested Linux operating system. This is because is it is used heavily in the Azure infrastructure we use for continuous testing and deployment. This platform also has official Microsoft .NET support and Official Docker Images.

Ubuntu 20

Official Microsoft Docker Images:

• 64 bit Ubuntu 20.04 Docker Image for .NET Runtime 3.1 ('3.1-focal')
• 64 bit Ubuntu 20.04 Docker Image for .NET Runtime 5.0 ('5.0-focal')

Ubuntu 20 Setup To Run IronBarCode add This Commands To Docker File and ensure you have sudo admin privileges.

RUN apt update
RUN apt install -y libgdiplus

Ubuntu 18

Official Microsoft Docker Images:

• 64 bit Ubuntu 18.04 Docker Image for .NET Runtime 3.1 ('3.1-bionic')
• Although there is no official docker image for .NET 5 on Ubuntu 18, compatibility is very high.

Ubuntu 18 Setup To Run IronBarCode add This Commands To Docker File and ensure you have sudo admin privileges.

RUN apt update
RUN apt install -y libgdiplus

Debian 11

Debian 10 is the default Linux distribution used by Microsoft when adding Docker support to a .NET project in Visual Studio.

Official Microsoft Docker Images:

• 64 bit Debian 11 Docker Image for .NET Runtime 3.1
• 64 bit Debian 11 Docker Image for .NET Runtime 5.0

Debian 11 Setup To Run IronBarCode add This Commands To Docker File and ensure you have sudo admin privileges.

RUN apt update
RUN apt install -y libgdiplus

Debian 10

Debian 10 is the default Linux distribution used by Microsoft when adding Docker support to a .NET project in Visual Studio.

Official Microsoft Docker Images:

• 64 bit Debian 10 Docker Image for .NET Runtime 3.1
• 64 bit Debian 10 Docker Image for .NET Runtime 5.0

Debian 10 Setup To Run IronBarCode add This Commands To Docker File and ensure you have sudo admin privileges.

RUN apt update
RUN apt install -y libgdiplus

CentOS 7 Setup To Run IronBarCode add This Commands To Docker File and ensure you have sudo admin privileges.

RUN yum install epel-release -y
RUN sudo yum install mono-complete -y
RUN sudo yum install libgdiplus libc6-dev -y

Common Dependency Patterns for Linux Please also study the dependency packages for other linux OS's above.

RUN apt update
RUN apt install -y libgdiplus