Perform OCR in Docker

7 Aug 20234 minutes to read

The Syncfusion .NET OCR library is used to extract text from the scanned PDFs and images in the Docker application with the help of Google’s Tesseract Optical Character Recognition engine.

Steps to perform OCR on entire PDF document in Docker

Step 1: Create a new ASP.NET Core application project.
ASP.NET Core project creation

Step 2: In the project configuration window, name your project and select Next.
Docker project configuration window

Step 3: Enable the Docker support with Linux as a target OS.
Set the docker target

Step 4: Install the Syncfusion.PDF.OCR.NET NuGet package as a reference to your .NET Core application
OCR NuGet package installation


  1. Beginning from version 21.1.x, the default configuration includes the addition of the TesseractBinaries and Tesseract language data folder paths, eliminating the requirement to explicitly provide these paths.
  2. Starting with v16.2.0.x, if you reference Syncfusion assemblies from trial setup or from the NuGet feed, you also have to add “Syncfusion.Licensing” assembly reference and include a license key in your projects. Please refer to this link to know about registering Syncfusion license key in your application to use our components.

Step 5: Include the following commands in the Docker file to install the dependent packages in the docker container.

  • C#
  • RUN apt-get update && \
    apt-get install -yq --no-install-recommends \
    libgdiplus libc6-dev

    OCR commends in docker file

    Step 6: A default action method named Index will be present in the HomeController.cs. Right-click on the Index method and select Go to View, where you will be directed to its associated view page Index.cshtml.

    Step 7: Add a new button in the index.cshtml as follows.

  • C#
  • @{Html.BeginForm("PerformOCR", "Home", FormMethod.Get);
                <input type="submit" value="Perform OCR on entire PDF" style="width:200px;height:27px" />

    Action method file screenshot

    Step 8: A default controller with the name HomeController.cs gets added to the creation of the ASP.NET Core project. Include the following namespaces in that HomeController.cs file.

  • C#
  • using Syncfusion.OCRProcessor;
    using Syncfusion.Pdf.Parsing;

    Step 9: Add a new action method PerformOCR in the HomeController.cs, and include the code sample to perform OCR on the entire PDF document using PerformOCR method of the OCRProcessor class.

  • C#
  • public ActionResult PerformOCR()
       string docPath = _hostingEnvironment.WebRootPath + "/Data/Input.pdf";
        //Initialize the OCR processor.
        using (OCRProcessor processor = new OCRProcessor())
            FileStream fileStream = new FileStream(docPath, FileMode.Open, FileAccess.Read);
            //Load a PDF document
            PdfLoadedDocument lDoc = new PdfLoadedDocument(fileStream);
            //Set OCR language to process
            processor.Settings.Language = Languages.English;
            //Process OCR by providing the PDF document.
            //Create memory stream
            MemoryStream stream = new MemoryStream();
            //Save the document to memory stream
            //Set the position as '0'
            stream.Position = 0;
            //Download the PDF document in the browser
            FileStreamResult fileStreamResult = new FileStreamResult(stream, "application/pdf");
            fileStreamResult.FileDownloadName = "Sample.pdf";
            return fileStreamResult;

    Step 10: Build and run the sample in Docker. It will pull the Linux Docker image from the Docker hub and run the project. Now, the webpage will open in the browser. Click the button to convert the webpage to a PDF.

    By executing the program, you will get a PDF document as follows.

    Linux docker output

    A complete working sample for converting an HTML to PDF in the Linux docker container can be downloaded from Github.

    Click here to explore the rich set of Syncfusion PDF library features.