Apache Tomcat 10 Server auf Windows 10/11: Vollständige Installation und Einrichtung von CATALINA_HOME
Dieses Tutorial führt dich Schritt für Schritt durch die vollständige manuelle Installation des Apache Tomcat 10 Webservers auf Windows 10 oder Windows 11. Zudem lernst du, wie du die essenzielle Systemumgebungsvariable CATALINA_HOME korrekt konfigurierst.
Voraussetzungen
Bevor du Tomcat installierst, muss ein Java Development Kit (JDK) auf deinem System installiert sein (mindestens Java Version 11 oder höher wird für Tomcat 10 empfohlen).
- Prüfe in der Eingabeaufforderung (CMD), ob Java installiert ist:
java -version - Falls nicht vorhanden, lade dir zuerst ein JDK herunter (z. B. von Oracle, OpenJDK oder Eclipse Temurin) und installiere es.
Schritt 1: Apache Tomcat 10 herunterladen
- Besuche die offizielle Apache Tomcat Webseite: tomcat.apache.org.
- Klicke im Menü links unter Download auf Tomcat 10.
- Scrolle zum Bereich Binary Distributions -> Core.
- Wähle die Datei 64-bit Windows zip aus und lade sie herunter.
Schritt 2: Tomcat entpacken und platzieren
- Öffne den Ordner, in dem die heruntergeladene
.zip-Datei liegt. - Entpacke die Datei (Rechtsklick -> Alle extrahieren...).
- Benenne den entpackten Ordner der Einfachheit halber um in
Tomcat10. - Verschiebe diesen Ordner an einen festen Ort auf deinem System, z. B.:
C:\Tomcat10(Hinweis: Es ist ratsam, Pfade ohne Leerzeichen zu wählen).
Schritt 3: Umgebungsvariablen einrichten (JAVA_HOME & CATALINA_HOME)
Damit Windows und Tomcat wissen, wo Java und der Server liegen, müssen Umgebungsvariablen gesetzt werden.
1. Umgebungsvariablen-Fenster öffnen
- Drücke die Windows-Taste, tippe Umgebungsvariablen ein und wähle Systemumgebungsvariablen bearbeiten.
- Klicke im neuen Fenster unten auf den Button Umgebungsvariablen....
2. JAVA_HOME prüfen/anlegen
(Falls bereits vorhanden, überspringe diesen Punkt)
- Klicke unter Systemvariablen auf Neu....
- Name der Variablen:
JAVA_HOME - Wert der Variablen: Pfad zu deinem JDK (z. B.
C:\Program Files\Eclipse Adoptium\jdk-17...oderC:\Program Files\Java\jdk-...)
- Name der Variablen:
- Klicke auf OK.
3. CATALINA_HOME anlegen
- Klicke unter Systemvariablen erneut auf Neu....
- Name der Variablen:
CATALINA_HOME - Wert der Variablen: Der Pfad zu deinem Tomcat-Hauptordner (z. B.
C:\Tomcat10).
- Name der Variablen:
- Klicke auf OK.
4. Die Path-Variable erweitern
Damit du Tomcat-Befehle von überall in der Befehlszeile ausführen kannst:
- Suche unter Systemvariablen die Variable Path und wähle Bearbeiten....
- Klicke auf Neu und füge Folgendes hinzu:
%CATALINA_HOME%\bin - Bestätige alle geöffneten Fenster jeweils mit OK.
Schritt 4: Apache Tomcat starten
Es gibt zwei Wege, den Server zu starten:
Methode A: Über die Windows-Eingabeaufforderung (CMD)
- Öffne die Eingabeaufforderung (CMD).
- Gib folgenden Befehl ein und drücke Enter:
startup.bat(Ein neues Konsolenfenster öffnet sich. Schließe dieses Fenster nicht, da Tomcat darin läuft).
Methode B: Direkt über den Explorer
- Navigiere zu deinem Tomcat-Verzeichnis:
C:\Tomcat10\bin. - Mache einen Doppelklick auf die Datei
startup.bat.
Schritt 5: Installation testen
- Öffne einen Webbrowser deiner Wahl.
- Gib in die Adresszeile folgende URL ein:
http://localhost:8080 - Wenn alles geklappt hat, siehst du nun die offizielle Apache Tomcat Begrüßungsseite ("If you're seeing this, you've successfully installed Tomcat.").
Schritt 6: Apache Tomcat stoppen
Wenn du den Server beenden möchtest:
- Entweder: Schließe das geöffnete Tomcat-Konsolenfenster per Tastenkombination
Strg + C. - Oder: Öffne ein CMD-Fenster und gib
shutdown.batein (bzw. führe die Dateishutdown.batim Ordnerbinaus).
Häufige Fehlerbehebungen (Troubleshooting)
- Das Konsolenfenster schließt sich sofort nach dem Start:
Dies deutet fast immer auf ein Problem mit Java hin. Überprüfe, ob die Variable
JAVA_HOMEkorrekt auf das Hauptverzeichnis des JDKs verweist (nicht auf denbin-Unterordner). - Port 8080 ist bereits belegt:
Falls eine andere Anwendung (z. B. Oracle DB) bereits Port 8080 nutzt, kannst du den Port ändern.
- Öffne die Datei:
C:\Tomcat10\conf\server.xmlmit einem Texteditor. - Suche nach
<Connector port="8080" protocol="HTTP/1.1"und ändere8080beispielsweise in8081oder9090.
- Öffne die Datei: