Skip to content
On this page

Setup guide – Linux


You have to prepare the following folder structure:

├── ocr4all
│   ├── data
│   |   ├── [Your book]
│   |   |   ├── input
│   |   |   |   ├── 0001.png
│   |   |   |   ├── 0002.png
│   |   |   |   ├── ...
│   ├── models


  • ocr4all (main folder)
  • models (folder for the neural network models)
  • data (folder for the documents you want to recognize)
  • [Your book] (folder that contains all data of a single, specific print/book)
  • input (folder for original, coloured / grayscaled book scans on page level)

Docker Setup

OCR4all setup

  • The OCR4all folder structure detailed above (Preparation) can be located anywhere you want.
  • Open a terminal inside the OCR4all folder and load an OCR4all image by using the following command (this will take up a few minutes and requires a stable connection to the internet):
docker pull uniwuezpd/ocr4all
  • Create the OCR4all container using the following command:
sudo docker run -p 1476:8080 \
    -u `id -u root`:`id -g $USER` \
    --name ocr4all \
    -v $PWD/data:/var/ocr4all/data \
    -v $PWD/models:/var/ocr4all/models/custom \
    -it uniwuezpd/ocr4all
  • Do not enter line breaks manually!

Browser access and further use

  • OCR4all is optimized for Chrome/Chromium.

  • Browser access: http://localhost:1476/ocr4all/

  • In the browser tool, check Project Overview -> Project selection: If you can find the two pre-loaded books called "Cirurgia" and "GNM", the mapping (-v $PWD/data:/…) is working properly.

  • Otherwise, it´s likely that there was a typo in the “docker run” command, so you will have to create the container again. First, delete the container you just created:

  • Stop the process in the terminal using CTRL+C, then type:

docker rm ocr4all
  • Check and correct your command (as with most terminals, you can sift through your previous commands using the arrow keys), especially the -v $PWD/data:/… lines, then run it again.
  • If everything is set up properly, you are able to restart OCR4all in the future by using:
docker start –ia ocr4all