Alojar Jenkins® en un VPS administrado: sus compilaciones en su propio servidor

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.

Simon Vasconcelos Lee Por Publicado el 16 de noviembre de 202615 minutos de lectura

Todas las guías

Lo esencial

  1. La licencia MIT permite usar Jenkins libremente en una empresa, siempre que conserve su aviso de licencia. El nombre se rige aparte por la política de marca que ha adoptado el proyecto, la de la Linux Foundation.
  2. Elija la línea LTS: la 2.580.2, a fecha de 28 de octubre de 2026, que funciona con Java 21 o Java 25. Cada 12 semanas se selecciona una nueva base LTS.
  3. Instálelo con la imagen oficial 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.
  4. Ejecute las compilaciones en agentes y deje a 0 los ejecutores del controlador. Conceda los permisos con la seguridad basada en matriz y mantenga activa la protección CSRF.
  5. Haga copia de JENKINS_HOME, guarde secrets/master.key aparte y lea la guía de actualización de cada LTS antes de aplicarla.

Qué hace Jenkins

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.

La licencia MIT y la marca

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.

LTS o semanal: qué versión instalar

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íneaA fecha de 8 de noviembre de 2026Ritmo
LTSLa 2.580.2 del 28 de octubre de 2026, tras la 2.580.1 del 30 de septiembreTres versiones por base, .1, .2 y .3, cada una tras dos semanas de traslado de correcciones y dos semanas de pruebas
Semanal2.589Una 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 instalación con Docker Compose

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.

compose.yaml
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:
Caddyfile
jenkins.example.com {
  encode zstd gzip
  reverse_proxy jenkins:8080
}
Terminal
docker compose up -d

Dimensionar el servidor

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.

Con los paquetes de Debian o Ubuntu

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.

Terminal
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:

Terminal
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:

Ajuste del servicio
[Service]
Environment="JENKINS_LISTEN_ADDRESS=127.0.0.1"

Con Nginx y Certbot

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:

Bloque Nginx
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;
  }
}

Certbot instala después el certificado y se encarga de renovarlo:

Terminal
sudo certbot --nginx

La URL de Jenkins y el proxy inverso

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.

El primer arranque: la contraseña inicial y el asistente

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:

Terminal, con Docker Compose
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
Terminal, con los paquetes
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
  1. Pegue esta contraseña en la página Unlock Jenkins.
  2. Elija Install suggested plugins, el conjunto que aconseja la documentación cuando aún no sabe bien qué plugins necesita; los demás se añaden después en Manage Jenkins, Plugins.
  3. Cree el primer administrador, con una contraseña sólida. Si omite este paso, la cuenta admin conserva como contraseña la de desbloqueo.
  4. Indique la URL de Jenkins, como en la sección anterior.

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.

Las compilaciones en los agentes, el controlador para orquestar

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.

  1. Conecte al menos un agente: otra máquina, un contenedor o una nube. El agente necesita Java y una conexión de red con el controlador.
  2. En Manage Jenkins, Nodes, abra Built-In Node, después Configure, y ponga a 0 el número de ejecutores. Hágalo cuando ya haya un agente, porque las compilaciones esperan entonces a que arranque un agente. La imagen Docker fija 2 por defecto.
ConexiónCómoLado de la red
SSHEl controlador se conecta al agente, con el plugin SSH Build AgentsNingún puerto que abrir en el controlador
WebSocketEl agente se conecta al controlador por su dirección HTTPS, desde Jenkins 2.217Ningún puerto adicional: el proxy transmite WebSocket
TCP entranteEl agente se conecta al controlador en un puerto TCP dedicadoUn 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.

Las cuentas y los permisos

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:

EstrategiaLo que concedeCuándo elegirla
Anyone can do anythingTodos los derechos, incluso a los visitantes anónimosSolo para una prueba local
Logged-in users can do anythingTodos los derechos a cada cuenta conectada; el ajuste que deja el asistenteMientras solo tengan cuenta personas de plena confianza
Matrix-based securityPermisos concedidos por usuario o por grupoEl punto de partida que recomienda la documentación para producción
Project-based Matrix Authorization StrategyLa misma matriz, ampliada proyecto por proyectoPara 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.

Los plugins y sus actualizaciones

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 por correo electrónico

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 copia de seguridad de JENKINS_HOME

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.

ElementoLo que guardaCopia de seguridad
*.xml, entre ellos config.xmlLa configuración principal y la del sistemaObligatoria
jobs/Los trabajos y el historial de compilaciones; en builds/archive, los artefactos archivadosObligatoria; los artefactos según necesidad, ocupan mucho
plugins/*.jpiLos plugins instalados, en sus versionesRecomendada, para restaurar de forma idéntica
secrets/Las claves que cifran las credencialesLa carpeta, salvo master.key, guardado aparte
workspace/Los archivos descargados del control de versiones para las compilacionesOpcional: una nueva descarga los recrea
war/, cache/, tools/El WAR descomprimido, las herramientas descargadas y extraídasOpcional: 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.

Con Docker Compose

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:

Terminal, en la carpeta del compose.yaml
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
Terminal, una sola vez: la clave maestra
docker cp jenkins:/var/jenkins_home/secrets/master.key ./master.key

Con los paquetes

Terminal
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.

Validar una copia de seguridad

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:

Terminal
export JENKINS_HOME=/mnt/backup-test
java -jar jenkins.war --httpPort=9999

Las actualizaciones

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:

Terminal, con Docker Compose
docker compose pull
docker compose up -d
Terminal, con los paquetes
sudo apt update
sudo apt install jenkins

Quién hace qué en un VPS administrado

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.

TemaNuestros equiposUsted
El servidorActualizaciones del sistema y de seguridad, con intervenciones en el servidor incluidasEl momento que mejor convenga a su actividad
La supervisiónServidor vigilado las 24 horas del día, los 7 días de la semana, con intervención sin esperar su llamadaLa lectura de los registros de su instancia y de sus compilaciones
JenkinsSeguimiento proactivo: errores, lentitud y espacio en disco detectados, corrección recomendadaSu instalación, sus actualizaciones, sus plugins y sus ajustes, que aplica usted o su asistente de IA
Los pipelines y los agentesLos servidores que los soportan, vigilados y con copias de seguridadLos trabajos, los agentes, las cuentas, los permisos y las credenciales
Las copias de seguridadCada noche, cifradas y guardadas fuera de la máquina; restauración incluidaLos archivos propios de Jenkins, el archivo master.key, y la petición de restauración, cuando la necesite
La migraciónSu servidor actual migrado, gratisEl 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.

Jenkins, en un servidor que cuidamos por usted

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.

Descubrir los VPS administrados

Preguntas frecuentes

¿Jenkins es gratuito para una empresa?

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.

¿Qué versión de Jenkins instalar?

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.

¿Cómo instalar Jenkins con Docker?

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.

¿Dónde encontrar la contraseña de administrador inicial 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.

¿Las compilaciones deben ejecutarse en el controlador de Jenkins?

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.

¿Cómo proteger una instancia de Jenkins?

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.

¿Cómo hacer copia de seguridad de Jenkins?

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 Jenkins?

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.

Fuentes y documentación oficial

Contáctenos