Héberger Jenkins sur un VPS infogéré, c'est construire, tester et déployer vos projets depuis une machine à vous, que nos équipes tiennent à jour et supervisent jour et nuit. Jenkins est un logiciel libre sous licence MIT. Ce guide suit sa documentation officielle : le choix de la version LTS, l'installation avec Docker Compose ou par les paquets Linux, HTTPS et l'URL de Jenkins, les agents, les droits, les extensions, les sauvegardes et les mises à jour.
Par Simon Vasconcelos Lee
Publié le 16 novembre 2026Lecture : 16 minutes
jenkins/jenkins et ses étiquettes lts, ou par les paquets Linux du projet, derrière un proxy inverse en HTTPS ; renseignez ensuite cette adresse dans l'URL de Jenkins.JENKINS_HOME, gardez secrets/master.key à part, et lisez le guide de mise à jour de chaque LTS avant de l’appliquer.Jenkins se présente comme le principal serveur d'automatisation open source. Écrit en Java, il compte plus de 2 000 extensions pour automatiser à peu près tout. Son README cite ses usages les plus courants : construire les projets, lancer les tests pour repérer un défaut dès qu'il apparaît, analyser le code et déployer.
Jenkinsfile, que la documentation recommande de versionner avec le code du projet.Jenkins est publié sous licence MIT. Elle autorise à utiliser, copier, modifier, fusionner, publier, distribuer, sous-licencier et vendre le logiciel, à une condition : garder la mention de copyright et le texte de la licence dans toute copie. Vous pouvez donc faire tourner Jenkins en entreprise, pour vos projets comme pour ceux de vos clients, sans licence à acheter.
La licence couvre le code. Le nom « Jenkins » est une marque déposée de LF Charities, Inc., organisation liée à la Linux Foundation, et le projet applique la politique de marque de la Linux Foundation. Cette politique vise qui place le mot dans le nom de son propre produit ou service, et elle propose pour cela des formes comme « votre produit for Jenkins » : lisez-la si vous construisez une offre autour du logiciel. Citer Jenkins pour le décrire, comme dans ce guide, est un usage loyal.
Cette publication est indépendante du projet Jenkins, de LF Charities, Inc. et de la Linux Foundation : elle n’est ni affiliée à eux, ni parrainée, ni approuvée par eux.
Jenkins sort sur deux lignes. La version hebdomadaire apporte chaque semaine les nouveautés et les correctifs. La ligne LTS, pour Long-Term Support, part d'une version hebdomadaire retenue toutes les 12 semaines comme base, puis reçoit des correctifs rétroportés. La documentation présente les étiquettes LTS de l'image Docker comme la version la plus stable, prête pour la production : c'est celle que ce guide installe.
| Ligne | Au 8 novembre 2026 | Rythme |
|---|---|---|
| LTS | 2.580.2 du 28 octobre 2026, après la 2.580.1 du 30 septembre | Trois versions par base, .1, .2 et .3, chacune après deux semaines de rétroportage et deux semaines de test |
| Hebdomadaire | 2.589 | Une version par semaine |
La LTS 2.580.2 demande Java 21 ou Java 25 : avec une autre version, le contrôleur ne démarre pas. Le projet prévoit la fin de prise en charge de Java 21 en septembre 2027, et celle de Java 25 en septembre 2029. L'exigence vaut pour tout le système, contrôleur, agents et ligne de commande ; vos projets, eux, se construisent avec la version de Java qui leur convient.
La documentation recommande l'image officielle jenkins/jenkins. L'étiquette lts suit la LTS sur Java 21, lts-jdk25 la même LTS sur Java 25, et latest la version hebdomadaire. Sur un serveur où Docker est installé, créez un dossier et placez-y ce compose.yaml, tiré de l'exemple Caddy de la documentation : Caddy reçoit les visiteurs sur les ports 80 et 443, obtient le certificat HTTPS et transmet à Jenkins, joignable par le seul réseau interne.
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 : toutes les données y vivent, extensions et configuration comprises. Le README de l'image préfère ce volume à un dossier de l'hôte, qui expose à des problèmes de droits : l'utilisateur jenkins du conteneur a l'identifiant 1000.web. Le port 50000 sert aux agents entrants en TCP ; les agents par WebSocket ou par SSH s'en passent, il n'est donc pas publié ici.2.580.2-lts-jdk25 fige la version, là où lts-jdk25 suit la LTS du moment.La documentation fixe un minimum de 256 Mo de mémoire et de 1 Go de disque, 10 Go au moins en conteneur Docker, et recommande pour une petite équipe 4 Go de mémoire ou plus et 50 Go de disque ou plus. La mémoire du contrôleur va, selon elle, de 200 Mo pour une petite installation à plus de 70 Go pour les plus grandes ; chaque agent connecté y occupe 2 ou 3 fils d'exécution, soit environ 2 Mo ou plus. Le gros du travail, les builds, consomme sur les agents.
Sur un VPS infogéré, décrivez-nous vos projets et le rythme de vos builds : nous vous recommandons la taille du contrôleur et celle des agents.
Le projet publie aussi des paquets pour Debian et Ubuntu, Fedora, Red Hat Enterprise Linux et ses dérivées. Sur Debian ou Ubuntu, installez Java d'abord : la documentation le recommande vivement, car un Jenkins installé avant Java peut ne pas trouver de Java valide au démarrage.
sudo apt update
sudo apt install fontconfig openjdk-21-jre
java -version
Ajoutez ensuite le dépôt de la ligne LTS, debian-stable, avec sa clé de signature, puis installez 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
Le paquet crée un service systemd et un utilisateur jenkins, envoie son journal à journald (journalctl -u jenkins.service), garde ses données dans /var/lib/jenkins et écoute sur le port 8080, sur toutes les interfaces. Derrière un proxy posé sur le même serveur, limitez-le à l'adresse locale avec sudo systemctl edit jenkins, puis sudo systemctl restart jenkins :
[Service]
Environment="JENKINS_LISTEN_ADDRESS=127.0.0.1"
Ce bloc reprend l'exemple Nginx de la documentation, réduit à son bloc location /, la forme qu'elle prévoit quand Nginx ne lit pas lui-même les fichiers 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 sans barre oblique finale : la documentation signale qu'une barre à la fin de cette valeur crée des problèmes.Upgrade et Connection servent aux agents par WebSocket, et le map garde les connexions persistantes pour le reste du trafic.proxy_request_buffering off est nécessaire aux commandes de la ligne de commande de Jenkins passées en HTTP.client_max_body_size fixe la taille maximale d’un envoi, 10 Mo dans l’exemple.Certbot pose ensuite le certificat et se charge de le renouveler :
sudo certbot --nginx
Une fois Jenkins en ligne, renseignez son adresse publique, par exemple https://jenkins.example.com/, dans Manage Jenkins, System, section Jenkins Location (les libellés de la documentation, en anglais). Jenkins s'en sert pour toutes les adresses qu'il produit, dans l'interface comme dans les fichiers des agents, et pour communiquer avec les agents et les outils externes. Les options de port n'y changent rien : seule cette URL compte.
Jenkins surveille lui-même son proxy inverse. S'il affiche « It appears that your reverse proxy setup is broken », vérifiez d'abord que cette URL correspond à l'adresse que vous utilisez, puis que le proxy transmet X-Forwarded-Proto quand il reçoit en HTTPS et parle à Jenkins en HTTP, comme les deux exemples de ce guide.
Servi sous un chemin comme /jenkins plutôt que sous son propre nom de domaine, Jenkins doit connaître ce chemin : --prefix=/jenkins, par JENKINS_OPTS avec Docker ou JENKINS_PREFIX avec les paquets. La documentation recommande le même chemin des deux côtés, car le réécrire dans le proxy oblige à corriger un grand nombre d'adresses.
Au premier accès, Jenkins demande un mot de passe généré automatiquement, qu'il écrit dans son journal et dans secrets/initialAdminPassword. Ouvrez votre adresse HTTPS, puis lisez-le :
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
admin garde pour mot de passe celui de déverrouillage.L'assistant laisse la stratégie d'autorisation « Logged-in users can do anything » : chaque compte connecté a tous les droits. Elle convient tant que seules des personnes de pleine confiance ont un compte. Avant d'en ouvrir d'autres, passez à la sécurité matricielle, décrite plus bas.
Un build exécute des commandes que d'autres que l'administrateur contrôlent : les scripts de build, les tests, le code de chaque commit. Sur le nœud intégré, ces commandes ont le même accès aux fichiers du contrôleur que Jenkins lui-même. La documentation recommande donc de ne lancer aucun build sur le nœud intégré et de les confier à des agents, ce qui garde aussi le processeur et la mémoire du contrôleur pour son rôle.
| Connexion | Comment | Côté réseau |
|---|---|---|
| SSH | Le contrôleur se connecte à l’agent, avec l’extension SSH Build Agents | Aucun port à ouvrir sur le contrôleur |
| WebSocket | L’agent se connecte au contrôleur par son adresse HTTPS, depuis Jenkins 2.217 | Aucun port de plus : le proxy transmet WebSocket |
| TCP entrant | L’agent se connecte au contrôleur sur un port TCP dédié | Un port fixe à ouvrir et à publier, 50000 dans l’image Docker |
La documentation conseille des agents génériques et interchangeables, préparés par un outil de configuration, une image prête ou un conteneur : un agent tombé se remplace alors sans effort. Avec un seul serveur, elle propose un agent qui tourne sous un autre utilisateur du système, sans aucun accès en lecture ni en écriture à JENKINS_HOME et sans sudo. Sur un VPS infogéré, un second VPS peut aussi servir d'agent, dimensionné pour vos builds.
Le contrôle d’accès des agents vers le contrôleur, qui empêche un agent compromis d’envoyer des commandes au contrôleur, est toujours actif depuis Jenkins 2.326.
Jenkins sépare l'authentification, qui établit qui vous êtes, et l'autorisation, qui dit ce que vous pouvez faire. Sa base d'utilisateurs intégrée, active par défaut, convient aux petites équipes ; LDAP, Active Directory, SAML ou OpenID Connect se branchent par extension. Côté autorisation, voici les stratégies que décrit la documentation :
| Stratégie | Ce qu’elle donne | Quand la retenir |
|---|---|---|
| Anyone can do anything | Tous les droits, même aux visiteurs anonymes | Pour un essai local seulement |
| Logged-in users can do anything | Tous les droits à chaque compte connecté ; c’est le réglage laissé par l’assistant | Tant que seules des personnes de pleine confiance ont un compte |
| Matrix-based security | Des permissions accordées par utilisateur ou par groupe | Le point de départ que la documentation recommande pour la production |
| Project-based Matrix Authorization Strategy | La même matrice, complétée projet par projet | Pour réserver certains projets à certaines personnes |
Les deux stratégies matricielles viennent de l'extension Matrix Authorization Strategy, qui fait partie des extensions suggérées par l'assistant. Dans la matrice, accordez peu aux lignes anonymous et authenticated : Overall/Administer donné à authenticated revient à « Logged-in users can do anything ». Gardez la même prudence si vous ouvrez l'inscription libre ou un fournisseur d'identité où chacun peut se créer un compte.
JENKINS_HOME par les clés du dossier secrets, que la section des sauvegardes traite à part.Les extensions font la richesse de Jenkins, et chacune est du code qui tourne dans le contrôleur. Jenkins consulte l'Update Center une fois toutes les 24 heures ; les mises à jour paraissent dans l'onglet Updates de Manage Jenkins, Plugins, et s'appliquent au redémarrage. Le bouton Check now force la consultation.
En Docker, vous pouvez aussi construire votre propre image à partir de jenkins/jenkins et y installer vos extensions avec jenkins-plugin-cli, depuis une liste plugins.txt qui fixe leurs versions et que l'outil sait mettre à jour. Le README de l'image décrit cette méthode.
Les notifications de build passent par l'extension Mailer : un build en échec, le retour au succès après un échec ou un build devenu instable déclenchent un e-mail. Le serveur d'envoi se règle dans Manage Jenkins, System, section E-mail Notification.
Sur un VPS Simafri, l'envoi passe par un relais SMTP authentifié, sur le port 587 : l'adresse d'un compte de messagerie que vous avez déjà, ou Simafri Suite. Dans les options avancées, cochez Use SMTP Authentication avec l'identifiant et le mot de passe du compte, puis Use TLS : l'extension retient alors le port 587. L'option Test configuration by sending test e-mail envoie un message d'essai.
La documentation juge les sauvegardes du contrôleur d'une importance critique : elles servent à repartir après un sinistre, à retrouver une configuration changée par erreur, ou un fichier corrompu ou supprimé. Tout tient dans JENKINS_HOME : /var/jenkins_home dans l'image Docker, /var/lib/jenkins avec les paquets.
| Élément | Ce qu’il garde | À sauvegarder |
|---|---|---|
*.xml, dont config.xml | La configuration principale et celle du système | Obligatoire |
jobs/ | Les jobs et l’historique des builds ; dans builds/archive, les artefacts archivés | Obligatoire ; les artefacts selon le besoin, ils pèsent lourd |
plugins/*.jpi | Les extensions installées, à leurs versions | Recommandé, pour restaurer à l’identique |
secrets/ | Les clés qui chiffrent les identifiants | Le dossier, sauf master.key, gardée à part |
workspace/ | Les fichiers récupérés du dépôt pour les builds | Facultatif : un nouveau checkout les recrée |
war/, cache/, tools/ | Le WAR décompressé, les outils téléchargés et extraits | Facultatif : recréés au besoin |
La documentation demande de ne jamais placer la clé maîtresse dans la sauvegarde courante. secrets/master.key chiffre la clé qui protège vos identifiants : qui détient vos sauvegardes et cette clé lit tout. Copiez-la une fois, rangez-la à part dans un endroit très sûr, comme une clé SSH privée ; une restauration complète en a besoin.
Le README de l'image demande de traiter jenkins_home comme une base de données. Arrêtez Jenkins le temps de la copie, puis archivez le volume avec un conteneur temporaire, selon la méthode de la documentation 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
Une copie faite service arrêté est cohérente. Pour sauvegarder sans arrêt, la documentation cite les instantanés du système de fichiers, LVM, btrfs ou ZFS, plus cohérents et plus rapides qu'une copie à chaud ; parmi les extensions de sauvegarde libres, elle désigne thinBackup comme la seule encore maintenue. Donnez à chaque copie un nom horodaté, évitez /tmp, qui peut être vidé au redémarrage, et envoyez les copies terminées vers un serveur distant.
Posées sur le disque du serveur, ces archives entrent aussi dans ses sauvegardes de nuit.
La documentation demande de valider chaque sauvegarde, et propose la méthode simple : la restaurer dans un dossier temporaire, y remettre master.key, et lancer dessus un second Jenkins de la même version, sur un autre port :
export JENKINS_HOME=/mnt/backup-test
java -jar jenkins.war --httpPort=9999
Avant chaque mise à jour du cœur, lisez la page de la LTS visée dans les guides de mise à jour du projet : chaque section couvre le passage depuis la LTS précédente. Pour la 2.580.2, elle n'annonce aucun changement notable. Pour la 2.580.1, elle signale que plusieurs extensions détachées du cœur ne sont plus livrées dans le WAR : Jenkins les installe de lui-même quand l'Update Center est joignable. Sauvegardez ensuite JENKINS_HOME, puis mettez à jour :
docker compose pull
docker compose up -d
sudo apt update
sudo apt install jenkins
L'auto-hébergement demande de tenir le serveur en plus de l'application. Sur un VPS infogéré, nos équipes prennent le serveur en main et suivent votre instance de manière proactive ; Jenkins reste votre logiciel, avec ses pipelines, ses réglages et ses données.
| Sujet | Nos équipes | Vous |
|---|---|---|
| Le serveur | Mises à jour du système et de la sécurité, interventions sur le serveur comprises | Le moment qui convient à votre activité |
| La supervision | Serveur suivi 24 h/24 et 7 j/7, avec intervention sans attendre votre appel | La lecture des journaux de votre instance et de vos builds |
| Jenkins | Suivi proactif : erreurs, lenteurs et espace disque repérés, correction recommandée | Son installation, ses mises à jour, ses extensions et ses réglages, que vous appliquez, vous ou votre assistant IA |
| Les pipelines et les agents | Les serveurs qui les portent, surveillés et sauvegardés | Les jobs, les agents, les comptes, les droits et les identifiants |
| Les sauvegardes | Chaque nuit, chiffrées et gardées hors de la machine ; restauration comprise | Les archives propres à Jenkins, la clé master.key, et la demande de restauration, quand vous en avez besoin |
| La migration | Votre serveur actuel migré, offert | Le moment de la bascule |
Si vous préférez que nos équipes interviennent dans l'application elle-même, cette prestation se facture à l'heure ou au forfait, avec un chiffrage communiqué avant l'intervention.
Avec un VPS infogéré Simafri, nos équipes tiennent à jour le serveur de votre instance Jenkins, le surveillent jour et nuit et interviennent sans attendre votre appel ; elles suivent aussi votre instance de manière proactive et vous recommandent les corrections utiles, que vous appliquez, vous ou votre assistant IA. Les sauvegardes sont chiffrées chaque nuit et gardées hors de la machine, leur restauration est comprise, et la migration de votre serveur actuel est offerte.
Oui. Jenkins est sous licence MIT : vous pouvez l'utiliser, le modifier et le faire tourner en entreprise sans licence à acheter, en gardant sa mention de copyright et de licence. Reste le coût des serveurs qui portent le contrôleur et les agents.
La ligne LTS, que la documentation présente comme prête pour la production : la 2.580.2 au 28 octobre 2026. Elle demande Java 21 ou Java 25. Une nouvelle base LTS est retenue toutes les 12 semaines, et chaque base reçoit trois versions de correctifs.
Utilisez l'image officielle jenkins/jenkins avec une étiquette LTS, comme lts-jdk25, et un volume nommé monté sur /var/jenkins_home. Placez un proxy inverse en HTTPS devant, par exemple Caddy dans le même fichier compose.yaml, puis renseignez l'adresse publique dans l'URL de Jenkins.
Dans le journal de démarrage, et dans le fichier secrets/initialAdminPassword de JENKINS_HOME : /var/jenkins_home avec l'image Docker, /var/lib/jenkins avec les paquets. Collez-le sur la page Unlock Jenkins, puis créez votre propre compte administrateur.
La documentation recommande de les lancer sur des agents : sur le nœud intégré, un build a le même accès aux fichiers du contrôleur que Jenkins. Connectez un agent, par SSH ou WebSocket, puis passez à 0 les exécuteurs du nœud intégré.
Servez-la en HTTPS derrière un proxy inverse, passez à la sécurité matricielle, réservez Overall/Administer à des personnes de confiance, laissez la protection CSRF active, lancez les builds sur des agents et appliquez rapidement les versions LTS qui portent des correctifs de sécurité.
Archivez JENKINS_HOME, service arrêté ou par instantané du système de fichiers. Gardez secrets/master.key hors de cette sauvegarde, rangé à part en lieu très sûr, et validez chaque sauvegarde en la restaurant sur un Jenkins de test lancé sur un autre port.
Un VPS infogéré couvre le serveur : système, sécurité, supervision et sauvegardes. Nos équipes suivent aussi votre instance de manière proactive et vous recommandent les corrections utiles, que vous appliquez. Une intervention dans l'application se facture à l'heure ou au forfait.
Simafri
Parlons de votre projet
Dites-nous en deux mots ce qu'il vous faut : on revient vers vous rapidement.
Merci ! Votre demande a bien été envoyée. Nous vous répondrons rapidement.
Vous préférez l'email ? Écrivez-nous à support@simafri.com.