Alojar Jenkins en un VPS administrado significa compilar, probar y desplegar sus proyectos desde una máquina propia, que nuestros equipos mantienen actualizada y supervisan día y noche. Jenkins es software libre con licencia MIT. Esta guía sigue su documentación oficial: la elección de la versión LTS, la instalación con Docker Compose o con los paquetes Linux, HTTPS y la URL de Jenkins, los agentes, los permisos, los plugins, las copias de seguridad y las actualizaciones.
Por Simon Vasconcelos Lee
Publicado el 16 de noviembre de 202615 minutos de lectura
jenkins/jenkins y sus etiquetas lts, o con los paquetes Linux del proyecto, detrás de un proxy inverso en HTTPS; indique después esa dirección como URL de Jenkins.JENKINS_HOME, guarde secrets/master.key aparte y lea la guía de actualización de cada LTS antes de aplicarla.Jenkins se presenta como el principal servidor de automatización de código abierto. Escrito en Java, ofrece más de 2000 plugins para automatizar prácticamente cualquier cosa. Su README enumera sus usos más habituales: compilar proyectos, ejecutar pruebas para detectar los errores en cuanto aparecen, analizar el código de forma estática y desplegar.
Jenkinsfile, que la documentación recomienda guardar en el control de versiones del proyecto.Jenkins se publica bajo la licencia MIT. Permite usar, copiar, modificar, fusionar, publicar, distribuir, sublicenciar y vender el software, con una condición: conservar el aviso de copyright y el texto de la licencia en cualquier copia. Puede, por tanto, ejecutar Jenkins en su empresa, para sus propios proyectos y para los de sus clientes, sin ninguna licencia que comprar.
La licencia cubre el código. El nombre «Jenkins» es una marca registrada de LF Charities, Inc., organización vinculada a la Linux Foundation, y el proyecto aplica la política de marca de la Linux Foundation. Esa política se dirige a quien incluye la palabra en el nombre de su propio producto o servicio, y propone para ello formas como «su producto for Jenkins»: léala si construye una oferta en torno al software. Citar Jenkins para describirlo, como hace esta guía, es un uso legítimo.
Esta publicación es independiente del proyecto Jenkins, de LF Charities, Inc. y de la Linux Foundation: no está afiliada a ellos, ni patrocinada ni aprobada por ellos.
Jenkins se publica en dos líneas. La versión semanal trae nuevas funciones y correcciones cada semana. La línea LTS, por Long-Term Support, parte de una versión semanal seleccionada cada 12 semanas como base, y recibe después correcciones trasladadas. La documentación presenta las etiquetas LTS de la imagen Docker como la versión más estable, lista para producción: es la que instala esta guía.
| Línea | A fecha de 8 de noviembre de 2026 | Ritmo |
|---|---|---|
| LTS | La 2.580.2 del 28 de octubre de 2026, tras la 2.580.1 del 30 de septiembre | Tres versiones por base, .1, .2 y .3, cada una tras dos semanas de traslado de correcciones y dos semanas de pruebas |
| Semanal | 2.589 | Una versión por semana |
La LTS 2.580.2 exige Java 21 o Java 25: con cualquier otra versión, el controlador no arranca. El proyecto prevé terminar el soporte de Java 21 en septiembre de 2027, y el de Java 25 en septiembre de 2029. El requisito se aplica a todo el sistema, controlador, agentes y línea de comandos; sus proyectos, en cambio, se compilan con la versión de Java que les convenga.
La documentación recomienda la imagen oficial jenkins/jenkins. La etiqueta lts sigue la LTS con Java 21, lts-jdk25 la misma LTS con Java 25, y latest la versión semanal. En un servidor con Docker instalado, cree una carpeta y coloque en ella este compose.yaml, tomado del ejemplo con Caddy de la documentación: Caddy recibe a los visitantes en los puertos 80 y 443, obtiene el certificado HTTPS y transmite a Jenkins, que solo es accesible en la red interna.
services:
jenkins:
image: jenkins/jenkins:lts-jdk25
container_name: jenkins
restart: unless-stopped
volumes:
- jenkins_home:/var/jenkins_home
expose:
- "8080"
networks:
- web
caddy:
image: caddy:2
container_name: caddy
restart: unless-stopped
depends_on:
- jenkins
ports:
- "80:80"
- "443:443"
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile:ro
- caddy_data:/data
- caddy_config:/config
networks:
- web
networks:
web:
driver: bridge
volumes:
jenkins_home:
caddy_data:
caddy_config:
jenkins.example.com {
encode zstd gzip
reverse_proxy jenkins:8080
}
docker compose up -d
/var/jenkins_home: ahí viven todos los datos, plugins y configuración incluidos. El README de la imagen prefiere este volumen a una carpeta del servidor anfitrión, que puede causar problemas de permisos: el usuario jenkins del contenedor tiene el identificador 1000.web. El puerto 50000 lo usan los agentes TCP entrantes; los agentes WebSocket y SSH prescinden de él, así que aquí no se publica.2.580.2-lts-jdk25 fija la versión, mientras que lts-jdk25 sigue la LTS actual.La documentación fija un mínimo de 256 MB de memoria y 1 GB de disco, al menos 10 GB en un contenedor Docker, y recomienda 4 GB de memoria o más y 50 GB de disco o más para un equipo pequeño. Explica que la memoria del controlador va de 200 MB en una instalación pequeña a más de 70 GB en las mayores; cada agente conectado ocupa en él 2 o 3 hilos, unos 2 MB o más. El grueso del trabajo, las compilaciones, se ejecuta en los agentes.
En un VPS administrado, descríbanos sus proyectos y la frecuencia de sus compilaciones: le recomendamos el tamaño adecuado para el controlador y para los agentes.
El proyecto publica también paquetes para Debian y Ubuntu, Fedora, Red Hat Enterprise Linux y sus derivadas. En Debian o Ubuntu, instale primero Java: la documentación lo recomienda encarecidamente, ya que un Jenkins instalado antes que Java puede no encontrar una instalación de Java válida al arrancar.
sudo apt update
sudo apt install fontconfig openjdk-21-jre
java -version
Añada después el repositorio LTS, debian-stable, con su clave de firma, e instale Jenkins:
sudo wget -O /etc/apt/keyrings/jenkins-keyring.asc \
https://pkg.jenkins.io/debian-stable/jenkins.io-2026.key
echo "deb [signed-by=/etc/apt/keyrings/jenkins-keyring.asc]" \
https://pkg.jenkins.io/debian-stable binary/ | sudo tee \
/etc/apt/sources.list.d/jenkins.list > /dev/null
sudo apt update
sudo apt install jenkins
El paquete crea un servicio systemd y un usuario jenkins, envía su registro a journald (journalctl -u jenkins.service), guarda sus datos en /var/lib/jenkins y escucha en el puerto 8080, en todas las interfaces. Detrás de un proxy en el mismo servidor, limítelo a la dirección local con sudo systemctl edit jenkins y después sudo systemctl restart jenkins:
[Service]
Environment="JENKINS_LISTEN_ADDRESS=127.0.0.1"
Este bloque sigue el ejemplo de Nginx de la documentación, reducido a su bloque location /, la forma que prevé para cuando Nginx no lee por sí mismo los archivos de Jenkins:
upstream jenkins {
keepalive 32;
server 127.0.0.1:8080;
}
map $http_upgrade $connection_upgrade {
default upgrade;
'' '';
}
server {
listen 80;
server_name jenkins.example.com;
ignore_invalid_headers off;
location / {
sendfile off;
proxy_pass http://jenkins;
proxy_redirect default;
proxy_http_version 1.1;
proxy_set_header Connection $connection_upgrade;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_max_temp_file_size 0;
client_max_body_size 10m;
client_body_buffer_size 128k;
proxy_connect_timeout 90;
proxy_send_timeout 90;
proxy_read_timeout 90;
proxy_request_buffering off;
}
}
proxy_pass sin barra final: la documentación advierte de que terminar este valor con una barra causa problemas.Upgrade y Connection sirven a los agentes WebSocket, y el map mantiene las conexiones activas para el resto del tráfico.proxy_request_buffering off es necesario para los comandos de la línea de comandos de Jenkins enviados por HTTP.client_max_body_size fija el tamaño máximo de los envíos, 10 MB en el ejemplo.Certbot instala después el certificado y se encarga de renovarlo:
sudo certbot --nginx
Una vez Jenkins en línea, indique su dirección pública, por ejemplo https://jenkins.example.com/, en Manage Jenkins, System, en la sección Jenkins Location. Jenkins la usa para todas las direcciones que genera, en la interfaz como en los archivos de los agentes, y para comunicarse con los agentes y las herramientas externas. Las opciones de puerto no cambian nada: lo que cuenta es esta URL.
Jenkins vigila su propio proxy inverso. Si muestra «It appears that your reverse proxy setup is broken», compruebe primero que esta URL coincide con la dirección que usa, y después que el proxy envía X-Forwarded-Proto cuando recibe HTTPS y habla con Jenkins en HTTP, como hacen los dos ejemplos de esta guía.
Servido bajo una ruta como /jenkins en lugar de con su propio nombre de dominio, Jenkins debe conocer esa ruta: --prefix=/jenkins, mediante JENKINS_OPTS con Docker o JENKINS_PREFIX con los paquetes. La documentación recomienda la misma ruta a ambos lados, ya que reescribirla en el proxy obliga a corregir muchísimas direcciones.
En el primer acceso, Jenkins pide una contraseña generada automáticamente, que escribe en su registro y en secrets/initialAdminPassword. Abra su dirección HTTPS y léala después:
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
admin conserva como contraseña la de desbloqueo.El asistente deja en su sitio la estrategia de autorización «Logged-in users can do anything»: cada cuenta conectada tiene todos los derechos. Le conviene mientras solo tengan cuenta personas de plena confianza. Antes de abrir más cuentas, pase a la seguridad basada en matriz, que se describe más abajo.
Una compilación ejecuta comandos que controlan otras personas además del administrador: scripts de compilación, pruebas, el código de cada commit. En el nodo integrado, esos comandos tienen el mismo acceso al sistema de archivos del controlador que el propio Jenkins. La documentación recomienda, por tanto, no ejecutar ninguna compilación en el nodo integrado y confiarlas a agentes, lo que además reserva el procesador y la memoria del controlador para su propio trabajo.
| Conexión | Cómo | Lado de la red |
|---|---|---|
| SSH | El controlador se conecta al agente, con el plugin SSH Build Agents | Ningún puerto que abrir en el controlador |
| WebSocket | El agente se conecta al controlador por su dirección HTTPS, desde Jenkins 2.217 | Ningún puerto adicional: el proxy transmite WebSocket |
| TCP entrante | El agente se conecta al controlador en un puerto TCP dedicado | Un puerto fijo que abrir y publicar, el 50000 en la imagen Docker |
La documentación aconseja agentes genéricos e intercambiables, preparados con una herramienta de gestión de la configuración, una imagen preparada de antemano o un contenedor: un agente que cae se sustituye entonces sin esfuerzo. Con un solo servidor, sugiere un agente que se ejecute con otro usuario del sistema operativo, sin acceso de lectura ni de escritura a JENKINS_HOME y sin sudo. En un VPS administrado, un segundo VPS puede hacer también de agente, dimensionado para sus compilaciones.
El control de acceso del agente al controlador, que impide a un agente comprometido enviar comandos al controlador, está siempre activo desde Jenkins 2.326.
Jenkins separa la autenticación, que establece quién es usted, de la autorización, que dice lo que puede hacer. Su base de usuarios integrada, activa por defecto, conviene a los equipos pequeños; LDAP, Active Directory, SAML u OpenID Connect se conectan mediante plugins. Para la autorización, estas son las estrategias que describe la documentación:
| Estrategia | Lo que concede | Cuándo elegirla |
|---|---|---|
| Anyone can do anything | Todos los derechos, incluso a los visitantes anónimos | Solo para una prueba local |
| Logged-in users can do anything | Todos los derechos a cada cuenta conectada; el ajuste que deja el asistente | Mientras solo tengan cuenta personas de plena confianza |
| Matrix-based security | Permisos concedidos por usuario o por grupo | El punto de partida que recomienda la documentación para producción |
| Project-based Matrix Authorization Strategy | La misma matriz, ampliada proyecto por proyecto | Para reservar algunos proyectos a algunas personas |
Las dos estrategias de matriz proceden del plugin Matrix Authorization Strategy, que figura entre los plugins que sugiere el asistente. En la matriz, conceda poco a las filas anonymous y authenticated: Overall/Administer concedido a authenticated equivale a «Logged-in users can do anything». Tenga el mismo cuidado si abre el registro libre o un proveedor de identidad en el que cualquiera puede crear una cuenta.
JENKINS_HOME con las claves de la carpeta secrets, que la sección de copias de seguridad trata aparte.Los plugins son lo que hace a Jenkins tan versátil, y cada uno es código que se ejecuta dentro del controlador. Jenkins consulta el Update Center una vez cada 24 horas; las actualizaciones aparecen en la pestaña Updates de Manage Jenkins, Plugins, y surten efecto tras un reinicio. El botón Check now fuerza una consulta.
Con Docker, también puede construir su propia imagen a partir de jenkins/jenkins e instalar en ella sus plugins con jenkins-plugin-cli, desde una lista plugins.txt que fija sus versiones y que la herramienta sabe actualizar. El README de la imagen describe este método.
Las notificaciones de compilación pasan por el plugin Mailer: una compilación fallida, un éxito tras un fallo o una compilación que se vuelve inestable envían un correo. El servidor de envío se configura en Manage Jenkins, System, en la sección E-mail Notification.
En un VPS de Simafri, el envío pasa por un relé SMTP autenticado, en el puerto 587: la dirección de una cuenta de correo que ya tenga, o Simafri Suite. En las opciones avanzadas, marque Use SMTP Authentication con el usuario y la contraseña de la cuenta, y después Use TLS: el plugin usa entonces el puerto 587. La opción Test configuration by sending test e-mail envía un mensaje de prueba.
La documentación considera de importancia crítica las copias de seguridad del controlador: sirven para recuperarse de un desastre, para recuperar una configuración cambiada por error, o un archivo dañado o eliminado. Todo vive en JENKINS_HOME: /var/jenkins_home en la imagen Docker, /var/lib/jenkins con los paquetes.
| Elemento | Lo que guarda | Copia de seguridad |
|---|---|---|
*.xml, entre ellos config.xml | La configuración principal y la del sistema | Obligatoria |
jobs/ | Los trabajos y el historial de compilaciones; en builds/archive, los artefactos archivados | Obligatoria; los artefactos según necesidad, ocupan mucho |
plugins/*.jpi | Los plugins instalados, en sus versiones | Recomendada, para restaurar de forma idéntica |
secrets/ | Las claves que cifran las credenciales | La carpeta, salvo master.key, guardado aparte |
workspace/ | Los archivos descargados del control de versiones para las compilaciones | Opcional: una nueva descarga los recrea |
war/, cache/, tools/ | El WAR descomprimido, las herramientas descargadas y extraídas | Opcional: se recrean cuando hace falta |
La documentación pide no incluir nunca la clave maestra en su copia de seguridad habitual. secrets/master.key cifra la clave que protege sus credenciales: quien tenga sus copias y esta clave puede leerlo todo. Cópiela una vez y guárdela aparte en un lugar muy seguro, como una clave privada SSH; una restauración completa la necesita.
El README de la imagen pide tratar jenkins_home como una base de datos. Detenga Jenkins durante la copia y archive después el volumen con un contenedor temporal, según el método de la documentación de Docker:
docker compose stop jenkins
docker run --rm --volumes-from jenkins -v "$(pwd)":/backup ubuntu \
tar -czf /backup/jenkins_home-$(date +%F).tar.gz --exclude=./secrets/master.key -C /var/jenkins_home .
docker compose start jenkins
docker cp jenkins:/var/jenkins_home/secrets/master.key ./master.key
sudo systemctl stop jenkins
sudo tar -czf jenkins_home-$(date +%F).tar.gz --exclude=./secrets/master.key -C /var/lib/jenkins .
sudo systemctl start jenkins
Una copia hecha con el servicio detenido es coherente. Para hacer copia sin detenerlo, la documentación remite a las instantáneas del sistema de archivos, LVM, btrfs o ZFS, más coherentes y más rápidas que una copia en caliente; entre los plugins de copia de seguridad de código abierto, cita thinBackup como el único que sigue mantenido. Dé a cada copia un nombre con fecha y hora, evite /tmp, que puede vaciarse al reiniciar, y envíe las copias terminadas a un servidor remoto.
Colocados en el disco del servidor, estos archivos entran también en sus copias de seguridad nocturnas.
La documentación pide validar cada copia de seguridad, y da el método sencillo: restaurarla en una carpeta temporal, volver a colocar master.key y arrancar sobre ella un segundo Jenkins de la misma versión, en otro puerto:
export JENKINS_HOME=/mnt/backup-test
java -jar jenkins.war --httpPort=9999
Antes de cada actualización del núcleo, lea la página de la LTS de destino en las guías de actualización del proyecto: cada sección trata la actualización desde la LTS anterior. Para la 2.580.2, no indica ningún cambio notable. Para la 2.580.1, señala que varios plugins separados del núcleo ya no se incluyen en el WAR: Jenkins los instala por sí mismo cuando el Update Center está accesible. Haga después copia de JENKINS_HOME y actualice:
docker compose pull
docker compose up -d
sudo apt update
sudo apt install jenkins
El autoalojamiento exige mantener el servidor además de la aplicación. En un VPS administrado, nuestros equipos se encargan del servidor y siguen su instancia de forma proactiva; Jenkins sigue siendo su software, con sus pipelines, sus ajustes y sus datos.
| Tema | Nuestros equipos | Usted |
|---|---|---|
| El servidor | Actualizaciones del sistema y de seguridad, con intervenciones en el servidor incluidas | El momento que mejor convenga a su actividad |
| La supervisión | Servidor vigilado las 24 horas del día, los 7 días de la semana, con intervención sin esperar su llamada | La lectura de los registros de su instancia y de sus compilaciones |
| Jenkins | Seguimiento proactivo: errores, lentitud y espacio en disco detectados, corrección recomendada | Su instalación, sus actualizaciones, sus plugins y sus ajustes, que aplica usted o su asistente de IA |
| Los pipelines y los agentes | Los servidores que los soportan, vigilados y con copias de seguridad | Los trabajos, los agentes, las cuentas, los permisos y las credenciales |
| Las copias de seguridad | Cada noche, cifradas y guardadas fuera de la máquina; restauración incluida | Los archivos propios de Jenkins, el archivo master.key, y la petición de restauración, cuando la necesite |
| La migración | Su servidor actual migrado, gratis | El momento del cambio |
Si prefiere que nuestros equipos intervengan en la propia aplicación, ese servicio se factura por horas o a precio cerrado, con un presupuesto comunicado antes de la intervención.
Con un VPS administrado de Simafri, nuestros equipos mantienen actualizado el servidor de su instancia de Jenkins, lo vigilan día y noche e intervienen sin esperar su llamada; también siguen su instancia de forma proactiva y le recomiendan las correcciones útiles, que aplica usted o su asistente de IA. Las copias de seguridad se cifran cada noche y se guardan fuera de la máquina, su restauración está incluida, y la migración de su servidor actual es gratuita.
Sí. Jenkins tiene licencia MIT: puede usarlo, modificarlo y ejecutarlo en su empresa sin ninguna licencia que comprar, siempre que conserve su aviso de copyright y de licencia. Queda el coste de los servidores que soportan el controlador y los agentes.
La línea LTS, que la documentación presenta como lista para producción: la 2.580.2, a fecha de 28 de octubre de 2026. Exige Java 21 o Java 25. Cada 12 semanas se selecciona una nueva base LTS, y cada base recibe tres versiones de corrección.
Use la imagen oficial jenkins/jenkins con una etiqueta LTS, como lts-jdk25, y un volumen con nombre montado en /var/jenkins_home. Coloque delante un proxy inverso en HTTPS, por ejemplo Caddy en el mismo archivo compose.yaml, e indique después la dirección pública como URL de Jenkins.
En el registro de arranque, y en el archivo secrets/initialAdminPassword de JENKINS_HOME: /var/jenkins_home con la imagen Docker, /var/lib/jenkins con los paquetes. Péguela en la página Unlock Jenkins y cree después su propia cuenta de administrador.
La documentación recomienda ejecutarlas en agentes: en el nodo integrado, una compilación tiene el mismo acceso a los archivos del controlador que Jenkins. Conecte un agente, por SSH o WebSocket, y ponga después a 0 los ejecutores del nodo integrado.
Sírvala en HTTPS detrás de un proxy inverso, pase a la seguridad basada en matriz, reserve Overall/Administer a personas de confianza, mantenga activa la protección CSRF, ejecute las compilaciones en agentes y aplique sin demora las versiones LTS que traen correcciones de seguridad.
Archive JENKINS_HOME, con el servicio detenido o mediante una instantánea del sistema de archivos. Deje secrets/master.key fuera de esa copia, guardado aparte en un lugar muy seguro, y valide cada copia restaurándola en un Jenkins de prueba arrancado en otro puerto.
Un VPS administrado cubre el servidor: sistema, seguridad, supervisión y copias de seguridad. Nuestros equipos siguen también su instancia de forma proactiva y le recomiendan las correcciones útiles, que aplica usted. Una intervención en la aplicación se factura por horas o a precio cerrado.
Simafri
Hablemos de su proyecto
Díganos en pocas palabras lo que necesita: le respondemos rápidamente.
¡Gracias! Su solicitud ha sido enviada. Le responderemos en breve.
¿Prefiere el correo? Escríbanos a support@simafri.com.