Héberger Jenkins® sur un VPS géré : vos builds sur votre serveur

Héberger Jenkins sur un VPS gé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.

Simon Vasconcelos Lee Par Publié le 16 novembre 2026Lecture : 15 minutes

Tous les guides

L'essentiel

  1. La licence MIT permet d'utiliser Jenkins librement en entreprise, en gardant sa mention de licence. Le nom relève à part de la politique de marque que le projet a adoptée, celle de la Linux Foundation.
  2. Choisissez la ligne LTS : la 2.580.2 au 28 octobre 2026, qui tourne sur Java 21 ou Java 25. Une nouvelle base LTS est retenue toutes les 12 semaines.
  3. Installez-le avec l'image officielle jenkins/jenkins et ses étiquettes lts, ou par les paquets Linux du projet, derrière un mandataire inverse en HTTPS ; renseignez ensuite cette adresse dans l'URL de Jenkins.
  4. Lancez les builds sur des agents et passez à 0 les exécuteurs du contrôleur. Donnez les droits avec la sécurité matricielle et gardez la protection CSRF active.
  5. Sauvegardez JENKINS_HOME, gardez secrets/master.key à part, et lisez le guide de mise à jour de chaque LTS avant de l'appliquer.

Ce que fait Jenkins

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.

La licence MIT et la marque

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.

LTS ou version hebdomadaire : quelle version installer

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.

LigneAu 8 novembre 2026Rythme
LTS2.580.2 du 28 octobre 2026, après la 2.580.1 du 30 septembreTrois versions par base, .1, .2 et .3, chacune après deux semaines de rétroportage et deux semaines de test
Hebdomadaire2.589Une 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.

L'installation avec Docker Compose

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.

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

La taille du serveur

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 géré, décrivez-nous vos projets et le rythme de vos builds : nous vous recommandons la taille du contrôleur et celle des agents.

Avec les paquets Debian ou Ubuntu

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.

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

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

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 mandataire posé sur le même serveur, limitez-le à l'adresse locale avec sudo systemctl edit jenkins, puis sudo systemctl restart jenkins :

Surcharge du service
[Service]
Environment="JENKINS_LISTEN_ADDRESS=127.0.0.1"

Avec Nginx et Certbot

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 :

Bloc 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 installe ensuite le certificat et se charge de le renouveler :

Terminal
sudo certbot --nginx

L'URL de Jenkins et le mandataire inverse

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 mandataire inverse. S'il affiche « It appears that your reverse mandataire setup is broken », vérifiez d'abord que cette URL correspond à l'adresse que vous utilisez, puis que le mandataire 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 mandataire oblige à corriger un grand nombre d'adresses.

Le premier démarrage : mot de passe initial et assistant

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 :

Terminal, avec Docker Compose
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
Terminal, avec les paquets
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
  1. Collez ce mot de passe sur la page Unlock Jenkins.
  2. Choisissez Install suggested plugins, l'ensemble que la documentation conseille quand vous ne savez pas encore de quelles extensions vous aurez besoin ; les autres s'ajoutent ensuite dans Manage Jenkins, Plugins.
  3. Créez le premier administrateur, avec un mot de passe solide. Si vous sautez cette étape, le compte admin garde pour mot de passe celui de déverrouillage.
  4. Renseignez l'URL de Jenkins, comme dans la section précédente.

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.

Les builds sur des agents, le contrôleur pour orchestrer

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.

  1. Connectez au moins un agent : une autre machine, un conteneur ou une instance infonuagique. L'agent a besoin de Java et d'une connexion réseau vers le contrôleur.
  2. Dans Manage Jenkins, Nodes, ouvrez Built-In Node, puis Configure, et passez le nombre d'exécuteurs à 0. Faites-le une fois un agent en place, car les builds attendent alors un agent pour démarrer. L'image Docker en prévoit 2 par défaut.
ConnexionCommentCôté réseau
SSHLe contrôleur se connecte à l'agent, avec l'extension SSH Build AgentsAucun port à ouvrir sur le contrôleur
WebSocketL'agent se connecte au contrôleur par son adresse HTTPS, depuis Jenkins 2.217Aucun port de plus : le mandataire transmet WebSocket
TCP entrantL'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 gé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.

Les comptes et les droits

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égieCe qu'elle donneQuand la retenir
Anyone can do anythingTous les droits, même aux visiteurs anonymesPour un essai local seulement
Logged-in users can do anythingTous les droits à chaque compte connecté ; c'est le réglage laissé par l'assistantTant que seules des personnes de pleine confiance ont un compte
Matrix-based securityDes permissions accordées par utilisateur ou par groupeLe point de départ que la documentation recommande pour la production
Project-based Matrix Authorization StrategyLa même matrice, complétée projet par projetPour 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.

Les extensions et leurs mises à jour

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 par e-mail

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.

Les sauvegardes de JENKINS_HOME

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émentCe qu'il gardeÀ sauvegarder
*.xml, dont config.xmlLa configuration principale et celle du systèmeObligatoire
jobs/Les jobs et l'historique des builds ; dans builds/archive, les artefacts archivésObligatoire ; les artefacts selon le besoin, ils pèsent lourd
plugins/*.jpiLes extensions installées, à leurs versionsRecommandé, pour restaurer à l'identique
secrets/Les clés qui chiffrent les identifiantsLe dossier, sauf master.key, gardée à part
workspace/Les fichiers récupérés du dépôt pour les buildsFacultatif : un nouveau checkout les recrée
war/, cache/, tools/Le WAR décompressé, les outils téléchargés et extraitsFacultatif : 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.

Avec Docker Compose

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 :

Terminal, dans le dossier du 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, une seule fois : la clé maîtresse
docker cp jenkins:/var/jenkins_home/secrets/master.key ./master.key

Avec les paquets

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

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.

Vérifier une sauvegarde

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 :

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

Les mises à jour

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 :

Terminal, avec Docker Compose
docker compose pull
docker compose up -d
Terminal, avec les paquets
sudo apt update
sudo apt install jenkins

Qui fait quoi sur un VPS géré

L'auto-hébergement demande de tenir le serveur en plus de l'application. Sur un VPS gé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.

SujetNos équipesVous
Le serveurMises à jour du système et de la sécurité, interventions sur le serveur comprisesLe moment qui convient à votre activité
La supervisionServeur suivi 24 h/24 et 7 j/7, avec intervention sans attendre votre appelLa lecture des journaux de votre instance et de vos builds
JenkinsSuivi proactif : erreurs, lenteurs et espace disque repérés, correction recommandéeSon installation, ses mises à jour, ses extensions et ses réglages, que vous appliquez, vous ou votre assistant IA
Les pipelines et les agentsLes serveurs qui les portent, surveillés et sauvegardésLes jobs, les agents, les comptes, les droits et les identifiants
Les sauvegardesChaque nuit, chiffrées et gardées hors de la machine ; restauration compriseLes archives propres à Jenkins, la clé master.key, et la demande de restauration, quand vous en avez besoin
La migrationVotre serveur actuel migré, offertLe 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.

Jenkins, sur un serveur tenu pour vous

Avec un VPS gé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.

Découvrir les VPS gérés

Questions fréquentes

Jenkins est-il gratuit pour une entreprise ?

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.

Quelle version de Jenkins installer ?

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.

Comment installer Jenkins avec Docker ?

Utilisez l'image officielle jenkins/jenkins avec une étiquette LTS, comme lts-jdk25, et un volume nommé monté sur /var/jenkins_home. Placez un mandataire inverse en HTTPS devant, par exemple Caddy dans le même fichier compose.yaml, puis renseignez l'adresse publique dans l'URL de Jenkins.

Où trouver le mot de passe administrateur initial 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.

Faut-il lancer les builds sur le contrôleur Jenkins ?

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

Comment sécuriser une instance Jenkins ?

Servez-la en HTTPS derrière un mandataire 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é.

Comment sauvegarder Jenkins ?

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 géré couvre-t-il Jenkins ?

Un VPS gé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.

Sources et documentation officielle

Contactez-nous