Tesseract OCR installieren
in Minuten.
Eine vollständige, getestete Installationsanleitung für Windows, macOS, Linux, WSL2, Docker und Conda — inklusive PATH-Einrichtung, Sprachdaten, Verifikation und Lösungen für die häufigsten Fehler.
Schnellinstallation (ein Befehl)
Kopieren Sie den Befehl für Ihre Plattform. Sprachen und PATH werden unten erläutert.
Windows
Paketmanager oder der UB-Mannheim-Installer.
> winget install UB-Mannheim.TesseractOCR
macOS
Homebrew ist die empfohlene Methode.
$ brew install tesseract
Ubuntu / Debian
In den offiziellen Repositories verfügbar.
$ sudo apt install tesseract-ocr
Welche Installationsmethode soll ich verwenden?
Wählen Sie die Zeile für Ihre Umgebung. Der Rest der Anleitung beschreibt jede Methode im Detail.
| Methode | Empfohlen für | Sprachen | Adminrechte |
|---|---|---|---|
| UB-Mannheim-Installer (Windows) | Die meisten Windows-Nutzer | Bei der Installation wählbar | Ja (systemweit) |
| winget / scoop / choco | Skript- oder Benutzerinstallationen unter Windows | Separat hinzufügen | scoop: nein |
| Homebrew / MacPorts (macOS) | macOS-Entwicklung | tesseract-lang | Nein |
| apt / dnf / pacman / apk | Linux-Server und -Desktops | Pakete je Sprache | Ja (sudo) |
| WSL2 | Windows-Nutzer, die auch Modelle trainieren | apt-Pakete | Nein |
| Docker | Reproduzierbare Dienste und CI | Im Image enthalten | Nein |
| Conda | Data-Science-Umgebungen | conda-forge | Nein |
Unter Windows installieren
Tesseract lässt sich unter Windows nicht trivial kompilieren. Nutzen Sie den Community-Installer oder einen Paketmanager und fügen Sie es zum PATH hinzu.
Option A — UB-Mannheim-Installer (empfohlen)
Das Projekt UB Mannheim veröffentlicht die Standard-Builds für Tesseract 5.x unter Windows, in 64 und 32 Bit. Der Installer enthält die Trainingswerkzeuge und lässt Sie Sprachen auswählen.
- Laden Sie die neueste
tesseract-ocr-w64-setup-5.x.exevon der UB-Mannheim-Seite herunter. - Führen Sie den Installer aus und wählen Sie die benötigten Sprachen (oder alle).
- Installieren Sie in den Standardpfad
C:\Program Files\Tesseract-OCR. - Fügen Sie diesen Ordner zum PATH hinzu (siehe unten) und starten Sie das Terminal neu.
Option B — Paketmanager
> winget search tesseract
> winget install UB-Mannheim.TesseractOCR
> scoop install tesseract
> choco install tesseract
Paket-IDs ändern sich mit der Zeit: Führen Sie winget search tesseract oder scoop search tesseract aus, falls ein Befehl fehlschlägt.
Tesseract zum PATH hinzufügen (der Schritt, den alle vergessen)
Nach der Installation mit UB Mannheim wird tesseract erst gefunden, wenn der Ordner im PATH steht.
- Öffnen Sie das Startmenü, suchen Sie Umgebungsvariablen und wählen Sie Systemumgebungsvariablen bearbeiten.
- Klicken Sie auf Umgebungsvariablen… und wählen Sie unter Systemvariablen den Eintrag Path → Bearbeiten.
- Klicken Sie auf Neu und fügen Sie
C:\Program Files\Tesseract-OCRhinzu. - Bestätigen Sie alles und starten Sie das Terminal (und die IDE) vollständig neu.
> tesseract --version
Unter macOS installieren
Homebrew ist die empfohlene Methode, sowohl auf Apple Silicon als auch auf Intel.
$ brew install tesseract
$ brew install tesseract-lang # alle Sprachen
Homebrew installiert Binaries unter /opt/homebrew/bin (Apple Silicon) oder /usr/local/bin (Intel). Die Sprachdaten liegen im tessdata-Verzeichnis; finden Sie es mit brew info tesseract.
Alternative mit MacPorts
$ sudo port install tesseract
$ sudo port install tesseract-sprachcode # z. B. tesseract-fra
Unter Linux installieren
Alle großen Distributionen liefern Tesseract in den offiziellen Repositories.
Debian / Ubuntu / Mint
$ sudo apt update
$ sudo apt install tesseract-ocr libtesseract-dev
$ sudo apt install tesseract-ocr-all # optional: alle Sprachen
Wenn apt das Paket nicht findet, aktivieren Sie das universe-Repository. libtesseract-dev ist nur zum Kompilieren gegen die API nötig.
Fedora / RHEL
$ sudo dnf install tesseract tesseract-devel tesseract-langpack-eng
Arch / Manjaro
$ sudo pacman -S tesseract tesseract-data-eng
Alpine
$ apk add tesseract-ocr tesseract-ocr-dev tesseract-ocr-data-eng
Sie brauchen eine neuere Version? Kompilieren Sie aus dem Quellcode nach der offiziellen Kompilieranleitung.
Unter Windows mit WSL2 installieren
WSL2 bietet eine vollständige Linux-Umgebung in Windows — der einfachste Weg, wenn Sie auch Modelle trainieren möchten.
> wsl --install -d Ubuntu
$ sudo apt update && sudo apt install tesseract-ocr tesseract-ocr-all libtesseract-dev
Mit Docker installieren
Für reproduzierbare Dienste und CI backen Sie Tesseract mit fester Version und Sprachen in ein Image.
Erstellen Sie ein Dockerfile:
FROM ubuntu:24.04
RUN apt-get update \
&& apt-get install -y --no-install-recommends \
tesseract-ocr tesseract-ocr-eng tesseract-ocr-deu libtesseract-dev \
&& rm -rf /var/lib/apt/lists/*
ENTRYPOINT ["tesseract"]$ docker build -t tesseract .
$ docker run --rm -v "$PWD:/data" tesseract /data/image.png /data/out
Binden Sie ein Volume ein, damit Tesseract das Bild liest und out.txt auf dem Host schreibt. Fügen Sie weitere tesseract-ocr-<sprache>-Pakete zum Dockerfile hinzu.
Mit Conda installieren
Ideal für Data-Science-Umgebungen, in denen Sie den System-Paketmanager nicht nutzen können.
$ conda install -c conda-forge tesseract
Sprachdaten installieren (tessdata)
Die Engine enthält standardmäßig Englisch. Fügen Sie weitere Sprachen als Pakete oder als .traineddata-Dateien hinzu.
Sprachpakete installieren
$ sudo apt install tesseract-ocr-fra tesseract-ocr-deu # Debian/Ubuntu
$ brew install tesseract-lang # macOS (alle)
$ sudo dnf install tesseract-langpack-fra # Fedora
Eine .traineddata-Datei manuell installieren
- Laden Sie die Sprachdatei aus den offiziellen Repositories: tessdata_fast (Geschwindigkeit), tessdata_best (Genauigkeit) oder tessdata (Legacy).
- Kopieren Sie die
.traineddata-Datei in Ihrtessdata-Verzeichnis (z. B.C:\Program Files\Tesseract-OCR\tessdata,/usr/share/tesseract-ocr/5/tessdataoder$(brew --prefix)/share/tessdata). - Liegen die Daten woanders, verweisen Sie mit der Umgebungsvariable
TESSDATA_PREFIXdarauf. - Prüfen Sie die verfügbaren Sprachen mit
tesseract --list-langs.
| Repository | Kompromiss | Verwenden, wenn |
|---|---|---|
tessdata_fast | Am kleinsten und schnellsten, etwas ungenauer | Echtzeit- oder Hochvolumen-Pipelines |
tessdata_best | Höchste Genauigkeit, langsamer und größer | Archivierung oder genauigkeitskritische Arbeit |
tessdata | Legacy + LSTM, unterstützt --oem 0 | Alte Modelle oder Legacy-Kompatibilität |
Installation prüfen
Führen Sie diese drei Prüfungen aus. Schlägt eine fehl, sehen Sie in die Fehlerbehebungstabelle.
$ tesseract --version
$ tesseract --list-langs
$ tesseract beispiel.png stdout -l eng
Ein erfolgreicher Lauf zeigt die Version, listet eng (und installierte Sprachen) und gibt den erkannten Text aus.
Aktualisieren, verwalten und deinstallieren
Halten Sie die Engine aktuell oder entfernen Sie sie sauber.
| Aufgabe | Windows | macOS | Linux |
|---|---|---|---|
| Aktualisieren | winget upgrade / Installer erneut ausführen | brew upgrade tesseract | sudo apt upgrade tesseract-ocr |
| Deinstallieren | winget uninstall UB-Mannheim.TesseractOCR | brew uninstall tesseract | sudo apt remove tesseract-ocr |
| Mehrere Versionen | Nur eine im PATH behalten | brew und MacPorts nicht mischen | PPA nutzen oder aus Quellen bauen |
Fehlerbehebung
Diese Fälle decken die meisten Installationsprobleme ab.
| Symptom | Ursache | Lösung |
|---|---|---|
tesseract: command not found | Installationsordner nicht im PATH | Fügen Sie C:\Program Files\Tesseract-OCR (Windows) oder das brew-bin (macOS) zum PATH hinzu und starten Sie das Terminal neu. |
Error opening data file .../eng.traineddata | Sprachdaten fehlen oder falscher Pfad | Installieren Sie das Sprachpaket oder setzen Sie TESSDATA_PREFIX auf den Ordner mit eng.traineddata. |
TesseractNotFoundError (Python) | pytesseract findet das Binary nicht | Setzen Sie pytesseract.pytesseract.tesseract_cmd auf den vollständigen Pfad oder korrigieren Sie den PATH. |
| Falsche Version | Mehr als eine Installation im PATH | PATH umsortieren oder Duplikat entfernen; which -a tesseract / where tesseract. |
| Zugriff verweigert | Systeminstallation ohne Rechte | Unter Linux sudo nutzen oder scoop/Conda für eine Benutzerinstallation. |
| Docker findet die Bilddatei nicht | Volume nicht eingebunden | Ordner mit -v "$PWD:/data" einbinden und im Container /data/... verwenden. |
Häufige Fragen zur Installation
Wie installiere ich Tesseract OCR unter Windows?
Laden Sie den UB-Mannheim-Installer für Tesseract 5.x herunter, führen Sie ihn aus, fügen Sie C:\Program Files\Tesseract-OCR zum PATH hinzu und prüfen Sie mit tesseract --version. Alternativ winget, scoop oder chocolatey.
Wie installiere ich Tesseract OCR unter Ubuntu?
Führen Sie sudo apt update && sudo apt install tesseract-ocr libtesseract-dev aus. Aktivieren Sie das universe-Repository, falls nötig, und installieren Sie tesseract-ocr-all für alle Sprachen.
Wo wird Tesseract installiert?
Windows: C:\Program Files\Tesseract-OCR. macOS mit Homebrew: /opt/homebrew (Apple Silicon) oder /usr/local (Intel). Linux: meist /usr/bin/tesseract, Daten unter /usr/share/tesseract-ocr/.
Muss ich für Python etwas installieren?
Ja. Der Wrapper pytesseract ruft das Tesseract-Binary auf, installieren Sie also zuerst die Engine und dann pip install pytesseract pillow. Die Dokumentation zeigt ein Minimalbeispiel.
Kann ich Tesseract ohne Administratorrechte installieren?
Ja. Nutzen Sie scoop oder eine portable Version unter Windows oder conda install -c conda-forge tesseract plattformübergreifend.
Ist Tesseract für die kommerzielle Nutzung kostenlos?
Ja. Tesseract steht unter der Apache-2.0-Lizenz und ist für private, akademische und kommerzielle Nutzung kostenlos.
Nächste Schritte
Nach der Installation erfahren Sie hier, wie Sie die Engine nutzen.