IronOCR Linux Compatibility & Setup Guide

This article was translated from English: Does it need improvement?
Translated
View the article in English

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

Linux Docker Azure AWS Ubuntu Debian

We recommend using .NET Core 3.1 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 IronOCR Linux. Generally, IronOCR works out of the box thanks to hundreds of hours of testing and configuration by our engineers.

Linux support is important because many cloud services 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 IronOCR.

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

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

IronOCR NuGet Packages

Install-Package IronOcr

Ubuntu Compatibility

Ubuntu is our most tested Linux operating system. This is because 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

Microsoft Ubuntu Chrome Safari Docker Azure

Manual Ubuntu 20 Setup: If you wish to manually install or your app cannot be run with sudo admin privileges.

# Update the package list
sudo apt update

# Install necessary packages
sudo apt install -y apt-utils libgdiplus libc6-dev
# Update the package list
sudo apt update

# Install necessary packages
sudo apt install -y apt-utils libgdiplus libc6-dev
SHELL

Ubuntu 18

Microsoft Ubuntu Chrome Safari Docker Azure

Manual Ubuntu 18 Setup: If you wish to manually install or your app cannot be run with sudo admin privileges.

# Update the package list
sudo apt update

# Install necessary packages
sudo apt install -y apt-utils libgdiplus libc6-dev
# Update the package list
sudo apt update

# Install necessary packages
sudo apt install -y apt-utils libgdiplus libc6-dev
SHELL

Debian 11

Debian Microsoft Chrome Safari Docker Azure

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

Manual Debian 11 Setup: If you wish to manually install or your app cannot be run with sudo admin privileges.

# Update the package list
sudo apt update

# Install necessary packages
sudo apt install -y apt-utils libgdiplus libc6-dev
# Update the package list
sudo apt update

# Install necessary packages
sudo apt install -y apt-utils libgdiplus libc6-dev
SHELL

Debian 10

Debian Microsoft Chrome Safari Docker Azure

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

Manual Debian 10 Setup: If you wish to manually install or your app cannot be run with sudo admin privileges.

# Update the package list
sudo apt update

# Install necessary packages
sudo apt install -y apt-utils libgdiplus libc6-dev
# Update the package list
sudo apt update

# Install necessary packages
sudo apt install -y apt-utils libgdiplus libc6-dev
SHELL

Other Linux Distros

Regardless of whether you use HFS, yum, apt, or apt-get as your package manager, the requirements remain pretty much constant.

# Update the package list
sudo apt update

# Install necessary packages and Tesseract OCR
sudo apt install -y apt-utils libgdiplus libc6-dev tesseract-ocr libtesseract-dev
# Update the package list
sudo apt update

# Install necessary packages and Tesseract OCR
sudo apt install -y apt-utils libgdiplus libc6-dev tesseract-ocr libtesseract-dev
SHELL

Preguntas Frecuentes

¿Cómo configuro Tesseract OCR en Linux usando C#?

Para configurar Tesseract OCR en Linux usando C#, puedes usar IronOCR. Primero, asegúrate de tener .NET Core instalado. Luego, instala el paquete NuGet de IronOCR usando PM> Install-Package IronOCR y sigue las instrucciones de configuración para configurar Tesseract OCR en tu sistema Linux.

¿Qué distribuciones de Linux son oficialmente compatibles con IronOCR?

IronOCR soporta oficialmente Ubuntu 20, Ubuntu 18, Debian 11 y Debian 10 para una configuración 'sin configuración', que permite una integración sin problemas con mínima configuración.

¿Puede utilizarse IronOCR con Docker en Linux?

Sí, IronOCR puede utilizarse con Docker en Linux. Debian 10 es la distribución de Linux predeterminada utilizada por Microsoft al agregar soporte de Docker a un proyecto .NET en Visual Studio, lo que lo hace compatible con IronOCR.

¿Es necesario modificar mi código C# para ejecutar IronOCR en Linux?

No, no es necesario modificar tu código C# para ejecutar IronOCR en Linux. El software está diseñado para funcionar de forma inmediata en las distribuciones de Linux compatibles gracias a las pruebas y configuraciones extensivas.

¿Por qué se recomienda utilizar versiones de soporte extendido (LTS) de .NET Core con IronOCR?

Se recomienda utilizar versiones de soporte extendido (LTS) de .NET Core con IronOCR porque garantiza estabilidad y fiabilidad, especialmente al implementar aplicaciones en servicios en la nube basados en Linux como Azure y AWS.

¿Cómo puedo instalar los paquetes necesarios para IronOCR en Ubuntu 20?

Para instalar los paquetes necesarios para IronOCR en Ubuntu 20, actualiza tu lista de paquetes e instala las dependencias requeridas con los comandos: sudo apt update y sudo apt install -y apt-utils libgdiplus libc6-dev.

¿Qué debo hacer si mi distribución de Linux no es oficialmente soportada por IronOCR?

Si tu distribución de Linux no es oficialmente soportada por IronOCR, aún puedes usar el software actualizando tu lista de paquetes e instalando los paquetes necesarios y Tesseract OCR usando tu gestor de paquetes.

¿Por qué es crítico el soporte de Linux para el software de OCR?

El soporte de Linux es crítico para el software de OCR como IronOCR porque muchos servicios en la nube, como Azure Web Apps, Azure Functions, AWS EC2, AWS Lambda, y Azure DevOps Docker, dependen en gran medida de Linux, lo que lo hace esencial para soluciones empresariales y SaaS.

¿IronOCR es compatible con .NET 10 en Linux y otras plataformas?

Sí, IronOCR es compatible con .NET 10 y las versiones 9, 8, 7, 6 y 5. Esto incluye compatibilidad multiplataforma con Windows, macOS, Linux, Docker, Azure y AWS. ([ironsoftware.com](https://ironsoftware.com/csharp/ocr/features/compatibility/?utm_source=openai))

Curtis Chau
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más
¿Listo para empezar?
Nuget Descargas 5,044,537 | Versión: 2025.11 recién lanzado