Instalar Apache Tomcat en Windows

Cómo instalar Apache Tomcat en Windows paso a paso

Apache Tomcat es un servidor de aplicaciones desarrollado por la Apache Software Foundation que implementa las especificaciones de Jakarta Servlet, Jakarta Server Pages (JSP), Jakarta Expression Language y WebSocket. Es una de las plataformas más utilizadas para ejecutar aplicaciones web desarrolladas en Java.

En este tutorial aprenderás a instalar Apache Tomcat en Windows desde cero, configurar las variables de entorno necesarias, iniciar el servidor y verificar que la instalación funciona correctamente.

Requisitos previos

Antes de instalar Tomcat es necesario tener instalado el JDK (Java Development Kit).

Windows 10 o Windows 11.
Java JDK 17 o superior. Revisa el post Cómo instalar Java en cualquier sistema operativo.
Permisos de administrador.
Conexión a Internet para descargar los archivos.

Instalar Java JDK

Instalar Java en Windows

Si todavía no tienes instalado Java, descarga una versión LTS del JDK e instálala normalmente.

Verificar Java

Una vez finalizada la instalación abre una consola (CMD o PowerShell) y ejecuta:

java -version

Deberías obtener una salida similar a:

openjdk version "21.0.2"

También verifica el compilador:

javac -version

Descargar Apache Tomcat

Descarga la versión ZIP de Apache Tomcat para Windows desde el sitio oficial.

En la sección Binary Distributions descarga el archivo: https://tomcat.apache.org/download-11.cgi

apache-tomcat-11.x.x.zip

También existe un instalador (.exe), pero la versión ZIP ofrece mayor flexibilidad y es la más utilizada en ambientes de desarrollo y servidores.

Descomprimir Tomcat

Extrae el contenido del archivo ZIP en una ubicación permanente.

Por ejemplo:

C:\tomcat

La estructura quedará similar a:

C:\
└── Tomcat
    ├── bin
    ├── conf
    ├── lib
    ├── logs
    ├── temp
    ├── webapps
    ├── work
    ├── BUILDING.txt
    ├── LICENSE
    └── README.md

Nota: en el post Carpetas y archivos de Apache Tomcat: estructura completa explicamos a detalle la estructura y su función.

Configurar las variables de entorno

Aprende a configurar las variables de entorno de Windows

Crear JAVA_HOME

Abre:

Panel de Control
Sistema
Configuración avanzada del sistema
Variables de entorno

Crea una nueva variable del sistema:

Variable	Valor
JAVA_HOME	C:\Program Files\Java\jdk-21

La ruta debe apuntar al directorio donde se instaló el JDK.

Modificar PATH

Agrega la siguiente entrada:

%JAVA_HOME%\bin

Crear CATALINA_HOME

Añade otra variable del sistema:

Variable	Valor
CATALINA_HOME	C:\tomcat

Verificar la configuración

Abre una nueva consola y ejecuta:

echo %JAVA_HOME%

Resultado esperado:

C:\Program Files\Java\jdk-21

Ahora verifica:

echo %CATALINA_HOME%

Resultado:

C:\Tomcat

Iniciar Apache Tomcat

Abre una consola y navega hasta el directorio bin.

cd %CATALINA_HOME%\bin

Para iniciar Tomcat ejecuta:

startup.bat

Se abrirá una nueva ventana donde Tomcat iniciará todos sus componentes.

Comprobar que Tomcat está ejecutándose

Ejecuta:

netstat -ano | findstr 8080

Si aparece una línea similar a la siguiente significa que Tomcat está escuchando correctamente:

TCP    0.0.0.0:8080    LISTENING

Abrir Tomcat desde el navegador

Abre tu navegador favorito e ingresa:

http://localhost:8080

Si todo está correctamente instalado aparecerá la página de bienvenida de Apache Tomcat.

Detener el servidor

Para apagar Tomcat ejecuta:

shutdown.bat

Scripts principales del directorio bin

Archivo	Descripción
startup.bat	Inicia Apache Tomcat.
shutdown.bat	Detiene el servidor.
catalina.bat	Script principal utilizado para iniciar, detener o depurar Tomcat.
version.bat	Muestra la versión de Tomcat y Java.
configtest.bat	Verifica la configuración del servidor.
digest.bat	Genera contraseñas cifradas para autenticación.
tool-wrapper.bat	Permite ejecutar herramientas adicionales utilizando el classpath de Tomcat.

Errores comunes

El puerto 8080 ya está en uso

Otro programa está utilizando el puerto 8080. Puedes identificar el proceso con:

netstat -ano | findstr 8080

Después consulta el proceso:

tasklist | findstr PID

JAVA_HOME no está definido

Este error indica que Tomcat no puede localizar el JDK. Verifica que la variable JAVA_HOME apunte al directorio del JDK y no al de un JRE.

No abre http://localhost:8080

Comprueba que Tomcat realmente esté iniciado, que el firewall de Windows no esté bloqueando el puerto y que no exista otro proceso utilizando el puerto 8080.

Conclusión

La instalación de Apache Tomcat en Windows consiste en cuatro pasos fundamentales: instalar el JDK, descargar y descomprimir Tomcat, configurar las variables de entorno e iniciar el servidor mediante los scripts del directorio bin. Una vez completados estos pasos podrás desplegar aplicaciones Java basadas en Servlets, JSP y otras tecnologías Jakarta EE utilizando el servidor Tomcat.

Preguntas frecuentes

¿Qué versión de Java necesito para Apache Tomcat 11?

Apache Tomcat 11 requiere una versión moderna de Java basada en Jakarta EE. La versión mínima recomendada es Java 17, aunque también es totalmente compatible con Java 21, que es una excelente opción por ser una versión LTS (Long-Term Support).

Versión de Tomcat	Java mínimo
Tomcat 9	Java 8
Tomcat 10	Java 11
Tomcat 11	Java 17

¿Cómo iniciar y detener Apache Tomcat?

Iniciar Tomcat

startup.bat

También puedes hacerlo mediante:

catalina.bat start

Detener Tomcat

shutdown.bat

O bien:

catalina.bat stop

Ejecutarlo en primer plano

Este modo es muy útil para visualizar los mensajes y errores directamente en la consola.

catalina.bat run

Una vez iniciado, verifica que el servidor está funcionando accediendo a:

http://localhost:8080

Preguntas frecuentes

¿Qué versión de Java necesito para Apache Tomcat 11?

¿Cómo iniciar y detener Apache Tomcat?

Comentario