Jenkins hosten op een Managed VPS betekent dat u uw projecten bouwt, test en uitrolt vanaf een machine die van u is, en die ons team bijwerkt en dag en nacht in de gaten houdt. Jenkins is vrije software onder de MIT-licentie. Deze gids volgt de officiële documentatie: de keuze van de LTS-versie, de installatie met Docker Compose of met de Linux-pakketten, HTTPS en de Jenkins URL, de agents, de rechten, de plug-ins, back-ups en upgrades.
Door Simon Vasconcelos Lee
Gepubliceerd op 16 november 2026Leestijd: 15 minuten
jenkins/jenkins en zijn tags lts, of met de Linux-pakketten van het project, achter een reverse proxy met HTTPS; stel dat adres daarna in als Jenkins URL.JENKINS_HOME, bewaar secrets/master.key apart, en lees de upgradegids van elke LTS voordat u haar toepast.Jenkins presenteert zich als de toonaangevende opensource automatiseringsserver. Gebouwd in Java, biedt het meer dan 2.000 plug-ins om vrijwel alles te automatiseren. De README somt de meest voorkomende toepassingen op: projecten bouwen, tests draaien om bugs op te sporen zodra ze binnensluipen, statische codeanalyse en uitrol.
Jenkinsfile, dat de documentatie aanraadt in het versiebeheer van het project op te nemen.Jenkins wordt gepubliceerd onder de MIT-licentie. Die staat toe de software te gebruiken, te kopiëren, te wijzigen, samen te voegen, te publiceren, te verspreiden, in sublicentie te geven en te verkopen, op één voorwaarde: behoud de copyrightvermelding en de tekst van de licentie in elke kopie. U kunt Jenkins dus in uw bedrijf draaien, voor uw eigen projecten en voor die van uw klanten, zonder een licentie te kopen.
De licentie dekt de code. De naam “Jenkins” is een geregistreerd merk van LF Charities, Inc., een organisatie verbonden aan de Linux Foundation, en het project volgt het merkbeleid van de Linux Foundation. Dat beleid geldt voor wie het woord in de naam van een eigen product of dienst opneemt, en het stelt daarvoor vormen voor zoals “uw product for Jenkins”: lees het als u een aanbod rond de software opbouwt. Jenkins noemen om het te beschrijven, zoals deze gids doet, is redelijk gebruik.
Deze publicatie is onafhankelijk van het Jenkins-project, van LF Charities, Inc. en van de Linux Foundation, en is niet met hen verbonden, noch door hen gesponsord of goedgekeurd.
Jenkins verschijnt in twee lijnen. De wekelijkse versie levert elke week nieuwe functies en correcties. De LTS-lijn, voor Long-Term Support, vertrekt van een wekelijkse versie die om de 12 weken als basis wordt gekozen, en krijgt daarna teruggebrachte correcties. De documentatie stelt de LTS-tags van de Docker-image voor als de stabielere versie, klaar voor productie: die installeert deze gids.
| Lijn | Op 8 november 2026 | Tempo |
|---|---|---|
| LTS | 2.580.2 van 28 oktober 2026, na 2.580.1 van 30 september | Drie versies per basis, .1, .2 en .3, elk na twee weken terugbrengen van correcties en twee weken testen |
| Wekelijks | 2.589 | Eén versie per week |
LTS 2.580.2 vraagt Java 21 of Java 25: met een andere versie start de controller niet. Het project is van plan de ondersteuning van Java 21 te beëindigen in september 2027, en die van Java 25 in september 2029. De vereiste geldt voor het hele systeem, controller, agents en opdrachtregel; uw projecten zelf bouwen met de Java-versie die bij hen past.
De documentatie beveelt de officiële image jenkins/jenkins aan. De tag lts volgt de LTS op Java 21, lts-jdk25 dezelfde LTS op Java 25, en latest de wekelijkse versie. Maak op een server waar Docker is geïnstalleerd een map aan en plaats daarin dit compose.yaml, overgenomen uit het Caddy-voorbeeld van de documentatie: Caddy ontvangt de bezoekers op de poorten 80 en 443, verkrijgt het HTTPS-certificaat en stuurt door naar Jenkins, dat alleen op het interne netwerk bereikbaar is.
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: alle gegevens staan daar, plug-ins en configuratie inbegrepen. De README van de image verkiest dit volume boven een map op de host, die tot problemen met rechten kan leiden: de gebruiker jenkins in de container heeft ID 1000.web. Poort 50000 dient voor inkomende TCP-agents; WebSocket- en SSH-agents hebben haar niet nodig, dus ze wordt hier niet gepubliceerd.2.580.2-lts-jdk25 legt de versie vast, terwijl lts-jdk25 de huidige LTS volgt.De documentatie legt een minimum vast van 256 MB geheugen en 1 GB schijf, minstens 10 GB in een Docker-container, en raadt voor een klein team 4 GB geheugen of meer en 50 GB schijf of meer aan. Ze legt uit dat het geheugen van de controller gaat van 200 MB voor een kleine installatie tot meer dan 70 GB voor de grootste; elke verbonden agent neemt daar 2 of 3 threads in, ongeveer 2 MB of meer. Het grootste deel van het werk, de builds, draait op de agents.
Vertel ons op een managed VPS over uw projecten en hoe vaak u bouwt: wij raden u de passende grootte aan voor de controller en voor de agents.
Het project publiceert ook pakketten voor Debian en Ubuntu, Fedora, Red Hat Enterprise Linux en zijn afgeleiden. Installeer op Debian of Ubuntu eerst Java: de documentatie raadt dat sterk aan, omdat een Jenkins die vóór Java is geïnstalleerd bij het opstarten mogelijk geen geldige Java-installatie vindt.
sudo apt update
sudo apt install fontconfig openjdk-21-jre
java -version
Voeg daarna de LTS-repository toe, debian-stable, met haar ondertekeningssleutel, en installeer 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
Het pakket maakt een systemd-dienst en een gebruiker jenkins aan, stuurt zijn logboek naar journald (journalctl -u jenkins.service), bewaart zijn gegevens in /var/lib/jenkins en luistert op poort 8080, op alle interfaces. Achter een proxy op dezelfde server beperkt u het tot het lokale adres met sudo systemctl edit jenkins, en daarna sudo systemctl restart jenkins:
[Service]
Environment="JENKINS_LISTEN_ADDRESS=127.0.0.1"
Dit blok volgt het Nginx-voorbeeld uit de documentatie, teruggebracht tot zijn blok location /, de vorm die ze voorziet wanneer Nginx de bestanden van Jenkins niet zelf leest:
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 zonder schuine streep aan het eind: de documentatie waarschuwt dat een schuine streep aan het eind van deze waarde problemen veroorzaakt.Upgrade en Connection dienen de WebSocket-agents, en de map houdt de verbindingen open voor de rest van het verkeer.proxy_request_buffering off is verplicht voor de opdrachten van de Jenkins-opdrachtregel die via HTTP worden verstuurd.client_max_body_size bepaalt de maximale grootte van een upload, 10 MB in het voorbeeld.Certbot plaatst daarna het certificaat en zorgt voor de vernieuwing ervan:
sudo certbot --nginx
Zodra Jenkins online staat, stelt u zijn openbare adres in, bijvoorbeeld https://jenkins.example.com/, bij Manage Jenkins, System, in de sectie Jenkins Location. Jenkins gebruikt het voor elk adres dat het aanmaakt, in de interface en in de bestanden van de agents, en voor de communicatie met de agents en externe tools. De poortopties maken daarvoor geen verschil: deze URL is wat telt.
Jenkins bewaakt zijn eigen reverse proxy. Toont het “It appears that your reverse proxy setup is broken”, controleer dan eerst of deze URL overeenkomt met het adres dat u gebruikt, en daarna of de proxy X-Forwarded-Proto meestuurt wanneer hij HTTPS ontvangt en via HTTP met Jenkins praat, zoals beide voorbeelden in deze gids doen.
Aangeboden onder een pad zoals /jenkins in plaats van onder een eigen domeinnaam, moet Jenkins dat pad kennen: --prefix=/jenkins, via JENKINS_OPTS met Docker of JENKINS_PREFIX met de pakketten. De documentatie raadt aan beide kanten hetzelfde pad aan, omdat het herschrijven ervan in de proxy betekent dat u heel veel adressen moet corrigeren.
Bij de eerste toegang vraagt Jenkins een automatisch gegenereerd wachtwoord, dat het in zijn logboek en in secrets/initialAdminPassword schrijft. Open uw HTTPS-adres en lees het daarna:
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
admin het ontgrendelingswachtwoord als wachtwoord.De wizard laat de autorisatiestrategie “Logged-in users can do anything” staan: elk aangemeld account heeft alle rechten. Dat past zolang alleen mensen die u volledig vertrouwt een account hebben. Schakel over op matrix-based security, hieronder beschreven, voordat u meer accounts opent.
Een build voert opdrachten uit die andere mensen dan de beheerder in handen hebben: buildscripts, tests, de code van elke commit. Op de ingebouwde node hebben die opdrachten dezelfde toegang tot het bestandssysteem van de controller als Jenkins zelf. De documentatie raadt daarom aan geen enkele build op de ingebouwde node te draaien en ze aan agents toe te vertrouwen, wat de CPU en het geheugen van de controller ook vrijhoudt voor zijn eigen taak.
| Verbinding | Hoe | Aan de netwerkkant |
|---|---|---|
| SSH | De controller maakt verbinding met de agent, met de plug-in SSH Build Agents | Geen poort te openen op de controller |
| WebSocket | De agent maakt verbinding met de controller via zijn HTTPS-adres, sinds Jenkins 2.217 | Geen extra poort: de proxy geeft WebSocket door |
| Inkomende TCP | De agent maakt verbinding met de controller op een eigen TCP-poort | Een vaste poort om te openen en te publiceren, 50000 in de Docker-image |
De documentatie raadt algemene, onderling verwisselbare agents aan, voorbereid met een tool voor configuratiebeheer, een vooraf gebouwde image of een container: een agent die uitvalt, vervangt u dan zonder moeite. Met één enkele server stelt ze een agent voor die onder een andere systeemgebruiker draait, zonder lees- of schrijftoegang tot JENKINS_HOME en zonder sudo. Op een managed VPS kan ook een tweede VPS als agent dienen, gedimensioneerd voor uw builds.
De toegangscontrole van agent naar controller, die verhindert dat een gecompromitteerde agent opdrachten naar de controller stuurt, staat sinds Jenkins 2.326 altijd aan.
Jenkins scheidt de authenticatie, die vaststelt wie u bent, van de autorisatie, die zegt wat u mag doen. Zijn ingebouwde gebruikersdatabase, standaard ingeschakeld, past bij kleine teams; LDAP, Active Directory, SAML of OpenID Connect sluiten aan via plug-ins. Voor de autorisatie beschrijft de documentatie deze strategieën:
| Strategie | Wat ze toekent | Wanneer u ze kiest |
|---|---|---|
| Anyone can do anything | Alle rechten, zelfs aan anonieme bezoekers | Alleen voor een lokale test |
| Logged-in users can do anything | Alle rechten aan elk aangemeld account; de instelling die de wizard laat staan | Zolang alleen mensen die u volledig vertrouwt een account hebben |
| Matrix-based security | Rechten toegekend per gebruiker of per groep | Het vertrekpunt dat de documentatie voor productie aanraadt |
| Project-based Matrix Authorization Strategy | Dezelfde matrix, project per project uitgebreid | Om bepaalde projecten voor bepaalde mensen te reserveren |
Beide matrixstrategieën komen uit de plug-in Matrix Authorization Strategy, die bij de plug-ins hoort die de wizard voorstelt. Ken in de matrix weinig toe aan de rijen anonymous en authenticated: Overall/Administer toegekend aan authenticated komt neer op “Logged-in users can do anything”. Wees even voorzichtig als u de zelfregistratie openzet of een identiteitsprovider gebruikt waar iedereen een account kan aanmaken.
JENKINS_HOME versleuteld met de sleutels uit de map secrets, die de sectie over back-ups apart behandelt.De plug-ins maken Jenkins zo veelzijdig, en elke plug-in is code die binnen de controller draait. Jenkins raadpleegt het Update Center eens per 24 uur; de updates verschijnen in het tabblad Updates van Manage Jenkins, Plugins, en gelden na een herstart. De knop Check now dwingt een controle af.
Met Docker kunt u ook uw eigen image bouwen vanaf jenkins/jenkins en er uw plug-ins in installeren met jenkins-plugin-cli, vanuit een lijst plugins.txt die hun versies vastlegt en die het hulpmiddel kan bijwerken. De README van de image beschrijft deze methode.
De meldingen van builds lopen via de plug-in Mailer: een mislukte build, een geslaagde build na een mislukking of een build die instabiel wordt, verstuurt een e-mail. De verzendserver stelt u in bij Manage Jenkins, System, in de sectie E-mail Notification.
Op een Simafri-VPS loopt het verzenden via een geauthenticeerde SMTP-relay, op poort 587: het adres van een e-mailaccount dat u al hebt, of Simafri Suite. Vink in de geavanceerde opties Use SMTP Authentication aan met de gebruikersnaam en het wachtwoord van het account, en daarna Use TLS: de plug-in gebruikt dan poort 587. De optie Test configuration by sending test e-mail verstuurt een testbericht.
De documentatie noemt de back-ups van de controller van cruciaal belang: ze dienen voor herstel na een ramp, om een per vergissing gewijzigde configuratie terug te halen, of een bestand dat beschadigd of verwijderd is. Alles staat in JENKINS_HOME: /var/jenkins_home in de Docker-image, /var/lib/jenkins met de pakketten.
| Onderdeel | Wat het bewaart | Te back-uppen |
|---|---|---|
*.xml, waaronder config.xml | De hoofdconfiguratie en de systeemconfiguratie | Verplicht |
jobs/ | De jobs en de buildgeschiedenis; in builds/archive, de gearchiveerde artefacten | Verplicht; de artefacten naargelang de behoefte, ze worden groot |
plugins/*.jpi | De geïnstalleerde plug-ins, in hun versies | Aanbevolen, om identiek terug te zetten |
secrets/ | De sleutels die de toegangsgegevens versleutelen | De map, behalve master.key, apart bewaard |
workspace/ | De bestanden die voor de builds uit het versiebeheer zijn opgehaald | Optioneel: een nieuwe checkout maakt ze opnieuw aan |
war/, cache/, tools/ | De uitgepakte WAR, de gedownloade en uitgepakte tools | Optioneel: opnieuw aangemaakt wanneer nodig |
De documentatie vraagt de hoofdsleutel nooit in uw gewone back-up op te nemen. secrets/master.key versleutelt de sleutel die uw toegangsgegevens beschermt: wie uw back-ups en deze sleutel heeft, leest alles. Kopieer haar één keer en bewaar haar apart op een zeer veilige plek, zoals een private SSH-sleutel; een volledig herstel heeft haar nodig.
De README van de image vraagt jenkins_home te behandelen als een database. Stop Jenkins zolang de kopie duurt, en archiveer daarna het volume met een tijdelijke container, volgens de methode uit de documentatie van 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
Een kopie gemaakt met de dienst gestopt is consistent. Om een back-up te maken zonder te stoppen, verwijst de documentatie naar snapshots van het bestandssysteem, LVM, btrfs of ZFS, die consistenter en sneller zijn dan een kopie tijdens de werking; bij de opensource back-upplug-ins noemt ze thinBackup als de enige die nog wordt onderhouden. Geef elke kopie een naam met tijdstempel, vermijd /tmp, dat bij een herstart kan worden leeggemaakt, en stuur de voltooide kopieën naar een externe server.
Staan deze archieven op de schijf van de server, dan vallen ze ook onder de nachtelijke back-ups.
De documentatie vraagt elke back-up te valideren, en geeft de eenvoudige methode: zet haar terug in een tijdelijke map, plaats master.key terug, en start daarop een tweede Jenkins van dezelfde versie, op een andere poort:
export JENKINS_HOME=/mnt/backup-test
java -jar jenkins.war --httpPort=9999
Lees vóór elke upgrade van de kern de pagina van de beoogde LTS in de upgradegidsen van het project: elke sectie behandelt de upgrade vanaf de vorige LTS. Voor 2.580.2 vermeldt ze geen opvallende wijzigingen. Voor 2.580.1 merkt ze op dat verschillende plug-ins die van de kern zijn losgemaakt, niet meer in de WAR zitten: Jenkins installeert ze zelf wanneer het Update Center bereikbaar is. Maak daarna een back-up van JENKINS_HOME en voer de upgrade uit:
docker compose pull
docker compose up -d
sudo apt update
sudo apt install jenkins
Self-hosting vraagt dat u naast de applicatie ook de server beheert. Op een managed VPS neemt ons team de server voor zijn rekening en houdt het uw instantie proactief in de gaten; Jenkins blijft uw software, met zijn pipelines, zijn instellingen en zijn gegevens.
| Onderwerp | Ons team | U |
|---|---|---|
| De server | Systeem- en beveiligingsupdates, ingrepen op de server inbegrepen | Het moment dat bij uw activiteit past |
| De monitoring | Server 24 uur per dag en 7 dagen per week bewaakt, met ingrijpen zonder op uw oproep te wachten | Het lezen van de logboeken van uw instantie en uw builds |
| Jenkins | Proactief toezicht: fouten, vertragingen en schijfruimte opgespoord, correctie aangeraden | De installatie, de updates, de plug-ins en de instellingen, die u toepast, zelf of via uw AI-assistent |
| De pipelines en de agents | De servers die ze dragen, bewaakt en geback-upt | De jobs, de agents, de accounts, de rechten en de toegangsgegevens |
| De back-ups | Elke nacht, versleuteld en buiten de machine bewaard; terugzetten inbegrepen | De eigen archieven van Jenkins, het bestand master.key, en het verzoek om terug te zetten, wanneer u dat nodig hebt |
| De migratie | Uw huidige server gemigreerd, gratis | Het moment van de overschakeling |
Wilt u liever dat ons team in de applicatie zelf ingrijpt, dan wordt die dienstverlening per uur of tegen een vast bedrag gefactureerd, met een offerte voordat het werk begint.
Met een Managed VPS van Simafri houdt ons team de server van uw Jenkins-instantie up-to-date, bewaakt hem dag en nacht en grijpt in zonder op uw oproep te wachten; het houdt ook uw instantie proactief in de gaten en raadt u de nuttige correcties aan, die u toepast, zelf of via uw AI-assistent. De back-ups worden elke nacht versleuteld en buiten de machine bewaard, het terugzetten is inbegrepen, en de migratie van uw huidige server is gratis.
Ja. Jenkins valt onder de MIT-licentie: u mag het in uw bedrijf gebruiken, wijzigen en draaien zonder een licentie te kopen, op voorwaarde dat u de copyright- en licentievermelding behoudt. Wat overblijft, zijn de kosten van de servers die de controller en de agents dragen.
De LTS-lijn, die de documentatie voorstelt als klaar voor productie: 2.580.2 op 28 oktober 2026. Ze vraagt Java 21 of Java 25. Om de 12 weken wordt een nieuwe LTS-basis gekozen, en elke basis krijgt drie correctieversies.
Gebruik de officiële image jenkins/jenkins met een LTS-tag, zoals lts-jdk25, en een benoemd volume gekoppeld op /var/jenkins_home. Zet er een reverse proxy met HTTPS voor, bijvoorbeeld Caddy in hetzelfde bestand compose.yaml, en stel daarna het openbare adres in als Jenkins URL.
In het opstartlogboek, en in het bestand secrets/initialAdminPassword van JENKINS_HOME: /var/jenkins_home met de Docker-image, /var/lib/jenkins met de pakketten. Plak het op de pagina Unlock Jenkins en maak daarna uw eigen beheerdersaccount aan.
De documentatie raadt aan ze op agents te draaien: op de ingebouwde node heeft een build dezelfde toegang tot de bestanden van de controller als Jenkins. Verbind een agent, via SSH of WebSocket, en zet daarna de executors van de ingebouwde node op 0.
Bied haar via HTTPS aan achter een reverse proxy, schakel over op matrix-based security, behoud Overall/Administer voor mensen die u vertrouwt, laat de CSRF-bescherming aan, laat de builds op agents draaien en pas de LTS-versies met beveiligingscorrecties snel toe.
Archiveer JENKINS_HOME, met de dienst gestopt of via een snapshot van het bestandssysteem. Houd secrets/master.key buiten die back-up, apart bewaard op een zeer veilige plek, en valideer elke back-up door haar terug te zetten op een test-Jenkins die op een andere poort is gestart.
Een managed VPS dekt de server: systeem, beveiliging, monitoring en back-ups. Ons team houdt ook uw instantie proactief in de gaten en raadt u de nuttige correcties aan, die u toepast. Een ingreep in de applicatie wordt per uur of tegen een vast bedrag gefactureerd.
Simafri
Laten we het over uw website hebben
Vertel ons in een paar woorden over uw project: wij nemen snel contact met u op.
Bedankt! Uw aanvraag is verzonden. We nemen spoedig contact met u op.
Liever per e-mail? Schrijf ons op support@simafri.com.