Att hosta Jenkins på en Managed VPS innebär att du bygger, testar och driftsätter dina projekt från en egen maskin, som våra team håller uppdaterad och bevakar dag och natt. Jenkins är fri programvara under MIT-licensen. Den här guiden följer den officiella dokumentationen: valet av LTS-version, installation med Docker Compose eller Linuxpaketen, HTTPS och Jenkins-URL:en, agenterna, behörigheterna, insticksprogrammen, säkerhetskopior och uppgraderingar.
Av Simon Vasconcelos Lee
Publicerad den 16 november 2026Lästid: 15 minuter
jenkins/jenkins och dess taggar lts, eller med projektets Linuxpaket, bakom en omvänd proxy med HTTPS; ange sedan den adressen som Jenkins-URL.JENKINS_HOME, förvara secrets/master.key separat och läs uppgraderingsguiden för varje LTS innan du tillämpar den.Jenkins beskriver sig som den ledande automationsservern med öppen källkod. Den är byggd i Java och erbjuder över 2 000 insticksprogram för att automatisera i stort sett vad som helst. README-filen listar de vanligaste användningarna: att bygga projekt, köra tester för att fånga fel så snart de införs, statisk kodanalys och driftsättning.
Jenkinsfile, som dokumentationen rekommenderar att checka in i projektets versionshantering.Jenkins ges ut under MIT-licensen. Den tillåter dig att använda, kopiera, ändra, slå samman, publicera, distribuera, underlicensiera och sälja programvaran, på ett villkor: att behålla upphovsrättsmeddelandet och licenstexten i varje kopia. Du kan alltså köra Jenkins i ditt företag, för dina egna projekt och för dina kunders, utan att köpa någon licens.
Licensen omfattar koden. Namnet ”Jenkins” är ett registrerat varumärke som tillhör LF Charities, Inc., en organisation knuten till Linux Foundation, och projektet följer Linux Foundations varumärkespolicy. Den policyn gäller den som sätter ordet i namnet på sin egen produkt eller tjänst, och den föreslår för det ändamålet former som ”din produkt for Jenkins”: läs den om du bygger ett erbjudande kring programvaran. Att nämna Jenkins för att beskriva det, som den här guiden gör, är tillåten användning.
Den här publikationen är oberoende av Jenkins-projektet, LF Charities, Inc. och Linux Foundation, och är varken knuten till, sponsrad eller godkänd av dem.
Jenkins ges ut i två linjer. Veckoversionen levererar nya funktioner och rättelser varje vecka. LTS-linjen, för Long-Term Support, utgår från en veckoversion som väljs ut var tolfte vecka som bas, och får sedan rättelser som förs tillbaka. Dokumentationen presenterar Docker-avbildens LTS-taggar som den stabilare versionen, redo för produktion: det är den som den här guiden installerar.
| Linje | Den 8 november 2026 | Takt |
|---|---|---|
| LTS | 2.580.2 från den 28 oktober 2026, efter 2.580.1 från den 30 september | Tre versioner per bas, .1, .2 och .3, var och en efter två veckors tillbakaföring och två veckors tester |
| Veckoversion | 2.589 | En version i veckan |
LTS 2.580.2 kräver Java 21 eller Java 25: med någon annan version startar inte kontrollenheten. Projektet planerar att avsluta stödet för Java 21 i september 2027, och för Java 25 i september 2029. Kravet gäller hela systemet, kontrollenhet, agenter och kommandorad; dina projekt bygger i sin tur med den Java-version som passar dem.
Dokumentationen rekommenderar den officiella avbilden jenkins/jenkins. Taggen lts följer LTS på Java 21, lts-jdk25 samma LTS på Java 25, och latest veckoversionen. På en server där Docker är installerat skapar du en mapp och lägger denna compose.yaml i den, hämtad från dokumentationens Caddy-exempel: Caddy tar emot besökarna på port 80 och 443, hämtar HTTPS-certifikatet och vidarebefordrar till Jenkins, som bara nås på det interna nätverket.
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: där finns alla data, insticksprogram och konfiguration inräknade. Avbildens README föredrar den volymen framför en mapp på värden, som kan leda till behörighetsproblem: användaren jenkins i containern har ID 1000.web. Port 50000 används av inkommande TCP-agenter; WebSocket- och SSH-agenter klarar sig utan den, så den publiceras inte här.2.580.2-lts-jdk25 fixerar versionen, medan lts-jdk25 följer den aktuella LTS-versionen.Dokumentationen anger ett minimum på 256 MB minne och 1 GB disk, minst 10 GB i en Docker-container, och rekommenderar 4 GB minne eller mer och 50 GB disk eller mer för ett litet team. Den förklarar att kontrollenhetens minne sträcker sig från 200 MB för en liten installation till över 70 GB för de största; varje ansluten agent tar där 2 eller 3 trådar, ungefär 2 MB eller mer. Huvuddelen av arbetet, byggena, körs på agenterna.
På en Managed VPS berättar du om dina projekt och hur ofta du bygger, så rekommenderar vi lämplig storlek för kontrollenheten och för agenterna.
Projektet publicerar också paket för Debian och Ubuntu, Fedora, Red Hat Enterprise Linux och dess derivat. På Debian eller Ubuntu installerar du Java först: dokumentationen rekommenderar det starkt, eftersom Jenkins som installeras före Java kan misslyckas med att hitta en giltig Java-installation vid start.
sudo apt update
sudo apt install fontconfig openjdk-21-jre
java -version
Lägg sedan till LTS-förrådet, debian-stable, med dess signeringsnyckel, och installera 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
Paketet skapar en systemd-tjänst och en användare jenkins, skickar sin logg till journald (journalctl -u jenkins.service), förvarar sina data i /var/lib/jenkins och lyssnar på port 8080, på alla gränssnitt. Bakom en proxy på samma server begränsar du den till den lokala adressen med sudo systemctl edit jenkins och sedan sudo systemctl restart jenkins:
[Service]
Environment="JENKINS_LISTEN_ADDRESS=127.0.0.1"
Det här blocket följer dokumentationens Nginx-exempel, begränsat till blocket location /, den form som den anger för när Nginx inte själv läser Jenkins filer:
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 utan avslutande snedstreck: dokumentationen varnar för att ett snedstreck i slutet av värdet orsakar problem.Upgrade och Connection betjänar WebSocket-agenterna, och map håller anslutningarna vid liv för resten av trafiken.proxy_request_buffering off krävs för Jenkins kommandoradskommandon som skickas över HTTP.client_max_body_size anger den största tillåtna uppladdningen, 10 MB i exemplet.Certbot installerar sedan certifikatet och sköter förnyelsen:
sudo certbot --nginx
När Jenkins är i drift anger du dess publika adress, till exempel https://jenkins.example.com/, under Manage Jenkins, System, i avsnittet Jenkins Location. Jenkins använder den för varje adress som den genererar, i gränssnittet som i agenternas filer, och för att kommunicera med agenter och externa verktyg. Portinställningarna spelar ingen roll för den: det är den här URL:en som gäller.
Jenkins övervakar sin egen omvända proxy. Om den visar ”It appears that your reverse proxy setup is broken” kontrollerar du först att URL:en stämmer med den adress du använder, och sedan att proxyn skickar X-Forwarded-Proto när den tar emot HTTPS och talar med Jenkins över HTTP, som båda exemplen i den här guiden gör.
Serveras Jenkins under en sökväg som /jenkins i stället för under ett eget domännamn måste den känna till sökvägen: --prefix=/jenkins, via JENKINS_OPTS med Docker eller JENKINS_PREFIX med paketen. Dokumentationen rekommenderar samma sökväg på båda sidor, eftersom en omskrivning i proxyn innebär att väldigt många adresser måste rättas.
Vid den första åtkomsten frågar Jenkins efter ett automatiskt genererat lösenord, som den skriver i sin logg och i secrets/initialAdminPassword. Öppna din HTTPS-adress och läs sedan lösenordet:
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
admin upplåsningslösenordet som sitt lösenord.Guiden lämnar auktoriseringsstrategin ”Logged-in users can do anything” på plats: varje inloggat konto har fullständiga rättigheter. Den passar så länge bara personer du litar helt på har ett konto. Innan du öppnar fler konton byter du till matrisbaserad säkerhet, som beskrivs nedan.
Ett bygge kör kommandon som andra än administratören styr över: byggskript, tester, koden i varje commit. På den inbyggda noden har de kommandona samma åtkomst till kontrollenhetens filsystem som Jenkins självt. Dokumentationen rekommenderar därför att inte köra några byggen på den inbyggda noden utan att lämna dem till agenter, vilket också sparar kontrollenhetens processor och minne åt dess eget arbete.
| Anslutning | Hur | På nätverkssidan |
|---|---|---|
| SSH | Kontrollenheten ansluter till agenten, med insticksprogrammet SSH Build Agents | Ingen port att öppna på kontrollenheten |
| WebSocket | Agenten ansluter till kontrollenheten via dess HTTPS-adress, sedan Jenkins 2.217 | Ingen extra port: proxyn vidarebefordrar WebSocket |
| Inkommande TCP | Agenten ansluter till kontrollenheten på en dedikerad TCP-port | En fast port att öppna och publicera, 50000 i Docker-avbilden |
Dokumentationen råder till generiska, utbytbara agenter, förberedda med ett verktyg för konfigurationshantering, en färdigbyggd avbild eller en container: en agent som går ned ersätts då utan möda. Med en enda server föreslår den en agent som körs som en annan användare i operativsystemet, utan läs- eller skrivåtkomst till JENKINS_HOME och utan sudo. På en Managed VPS kan en andra VPS också fungera som agent, dimensionerad för dina byggen.
Åtkomstkontrollen från agent till kontrollenhet, som hindrar en komprometterad agent från att skicka kommandon till kontrollenheten, är alltid aktiverad sedan Jenkins 2.326.
Jenkins skiljer autentisering, som fastställer vem du är, från auktorisering, som anger vad du får göra. Dess inbyggda användardatabas, aktiverad som standard, passar små team; LDAP, Active Directory, SAML eller OpenID Connect kopplas in via insticksprogram. För auktoriseringen är det här de strategier som dokumentationen beskriver:
| Strategi | Vad den ger | När den ska väljas |
|---|---|---|
| Anyone can do anything | Fullständiga rättigheter, även till anonyma besökare | Bara för ett lokalt test |
| Logged-in users can do anything | Fullständiga rättigheter till varje inloggat konto; den inställning som guiden lämnar | Så länge bara personer du litar helt på har ett konto |
| Matrix-based security | Behörigheter som ges per användare eller per grupp | Den utgångspunkt som dokumentationen rekommenderar för produktion |
| Project-based Matrix Authorization Strategy | Samma matris, utökad projekt för projekt | För att reservera vissa projekt för vissa personer |
Båda matrisstrategierna kommer från insticksprogrammet Matrix Authorization Strategy, som finns bland de insticksprogram som guiden föreslår. I matrisen ger du lite till raderna anonymous och authenticated: Overall/Administer som ges till authenticated motsvarar ”Logged-in users can do anything”. Var lika försiktig om du öppnar självregistrering eller en identitetsleverantör där vem som helst kan skapa ett konto.
JENKINS_HOME med nycklarna i mappen secrets, som avsnittet om säkerhetskopior behandlar separat.Insticksprogrammen är det som gör Jenkins så mångsidigt, och vart och ett är kod som körs inuti kontrollenheten. Jenkins kontrollerar Update Center en gång per dygn; uppdateringarna visas på fliken Updates under Manage Jenkins, Plugins, och börjar gälla efter en omstart. Knappen Check now tvingar fram en kontroll.
Med Docker kan du också bygga en egen avbild utifrån jenkins/jenkins och installera dina insticksprogram i den med jenkins-plugin-cli, från en lista plugins.txt som låser deras versioner och som verktyget kan uppdatera. Avbildens README beskriver den metoden.
Aviseringarna om byggen går via insticksprogrammet Mailer: ett misslyckat bygge, ett lyckat bygge efter ett misslyckande eller ett bygge som blir instabilt utlöser ett e-postmeddelande. Den utgående servern ställs in under Manage Jenkins, System, i avsnittet E-mail Notification.
På en VPS från Simafri går utskicken via ett autentiserat SMTP-relä, på port 587: adressen till ett e-postkonto som du redan har, eller Simafri Suite. I de avancerade alternativen markerar du Use SMTP Authentication med kontots användarnamn och lösenord, och sedan Use TLS: insticksprogrammet använder då port 587. Alternativet Test configuration by sending test e-mail skickar ett testmeddelande.
Dokumentationen kallar säkerhetskopiorna av kontrollenheten avgörande: de används vid katastrofåterställning, för att få tillbaka en konfiguration som ändrats av misstag, eller en fil som skadats eller tagits bort. Allt finns i JENKINS_HOME: /var/jenkins_home i Docker-avbilden, /var/lib/jenkins med paketen.
| Del | Vad den innehåller | Att säkerhetskopiera |
|---|---|---|
*.xml, inklusive config.xml | Huvudkonfigurationen och systemkonfigurationen | Obligatoriskt |
jobs/ | Jobben och bygghistoriken; i builds/archive, de arkiverade artefakterna | Obligatoriskt; artefakterna efter behov, de blir stora |
plugins/*.jpi | De installerade insticksprogrammen, i sina versioner | Rekommenderas, för att återställa identiskt |
secrets/ | Nycklarna som krypterar inloggningsuppgifterna | Mappen, utom master.key, som förvaras separat |
workspace/ | Filerna som hämtats från versionshanteringen för byggena | Valfritt: en ny utcheckning skapar dem på nytt |
war/, cache/, tools/ | Den uppackade WAR-filen, nedladdade och uppackade verktyg | Valfritt: skapas på nytt vid behov |
Dokumentationen ber dig att aldrig lägga huvudnyckeln i din vanliga säkerhetskopia. secrets/master.key krypterar nyckeln som skyddar dina inloggningsuppgifter: den som har dina säkerhetskopior och den här nyckeln kan läsa allt. Kopiera den en gång och förvara den separat på en mycket säker plats, som en privat SSH-nyckel; en fullständig återställning kräver den.
Avbildens README ber dig att behandla jenkins_home som en databas. Stoppa Jenkins under kopieringen och arkivera sedan volymen med en tillfällig container, enligt metoden i Dockers dokumentation:
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
En kopia som görs med tjänsten stoppad är konsekvent. För att säkerhetskopiera utan att stoppa hänvisar dokumentationen till ögonblicksbilder av filsystemet, LVM, btrfs eller ZFS, som är mer konsekventa och snabbare än en kopia under drift; bland insticksprogrammen för säkerhetskopiering med öppen källkod nämner den thinBackup som det enda som fortfarande underhålls. Ge varje kopia ett namn med tidsstämpel, undvik /tmp, som kan rensas vid omstart, och skicka färdiga kopior till en fjärrserver.
Lagda på serverns disk ingår de här arkiven också i dess nattliga säkerhetskopior.
Dokumentationen ber dig att validera varje säkerhetskopia och anger den enkla metoden: återställ den i en tillfällig mapp, lägg tillbaka master.key och starta en andra Jenkins av samma version på den, på en annan port:
export JENKINS_HOME=/mnt/backup-test
java -jar jenkins.war --httpPort=9999
Läs före varje uppgradering av kärnan sidan för mål-LTS:en i projektets uppgraderingsguider: varje avsnitt täcker uppgraderingen från föregående LTS. För 2.580.2 listar den inga anmärkningsvärda ändringar. För 2.580.1 påpekar den att flera insticksprogram som lösgjorts från kärnan inte längre följer med i WAR-filen: Jenkins installerar dem själv när Update Center går att nå. Säkerhetskopiera sedan JENKINS_HOME och uppgradera:
docker compose pull
docker compose up -d
sudo apt update
sudo apt install jenkins
Att självhosta innebär att sköta servern utöver applikationen. På en Managed VPS tar våra team hand om servern och följer din instans proaktivt; Jenkins förblir din programvara, med sina pipelines, sina inställningar och sina data.
| Område | Våra team | Du |
|---|---|---|
| Servern | Uppdateringar av system och säkerhet, ingrepp på servern inräknade | Tidpunkten som passar din verksamhet |
| Övervakningen | Servern följs dygnet runt, alla dagar, med ingrepp utan att vänta på ditt samtal | Läsningen av din instans och dina byggens loggar |
| Jenkins | Proaktiv uppföljning: fel, långsamma svarstider och diskutrymme upptäcks, med rekommenderad rättelse | Installationen, uppdateringarna, insticksprogrammen och inställningarna, som du genomför själv eller med din AI-assistent |
| Pipelines och agenter | Servrarna som bär dem, övervakade och säkerhetskopierade | Jobben, agenterna, kontona, behörigheterna och inloggningsuppgifterna |
| Säkerhetskopiorna | Varje natt, krypterade och förvarade utanför maskinen; återställning ingår | Jenkins egna arkiv, filen master.key och begäran om återställning, när du behöver den |
| Migreringen | Din nuvarande server migreras kostnadsfritt | Tidpunkten för bytet |
Om du föredrar att våra team ingriper i själva applikationen faktureras den tjänsten per timme eller som fast pris, med en offert som lämnas före ingreppet.
Med en Managed VPS från Simafri håller våra team servern för din Jenkins-instans uppdaterad, övervakar den dag och natt och griper in utan att vänta på ditt samtal; de följer också din instans proaktivt och rekommenderar de rättelser som är till nytta, som du genomför själv eller med din AI-assistent. Säkerhetskopiorna krypteras varje natt och förvaras utanför maskinen, återställningen ingår, och migreringen av din nuvarande server är kostnadsfri.
Ja. Jenkins är licensierat under MIT-licensen: du kan använda, ändra och köra det i ditt företag utan att köpa någon licens, så länge du behåller dess upphovsrätts- och licensmeddelande. Kvar blir kostnaden för servrarna som bär kontrollenheten och agenterna.
LTS-linjen, som dokumentationen presenterar som redo för produktion: 2.580.2 den 28 oktober 2026. Den kräver Java 21 eller Java 25. En ny LTS-bas väljs var tolfte vecka, och varje bas får tre rättelseversioner.
Använd den officiella avbilden jenkins/jenkins med en LTS-tagg, som lts-jdk25, och en namngiven volym monterad på /var/jenkins_home. Sätt en omvänd proxy med HTTPS framför, till exempel Caddy i samma fil compose.yaml, och ange sedan den publika adressen som Jenkins-URL.
I startloggen, och i filen secrets/initialAdminPassword i JENKINS_HOME: /var/jenkins_home med Docker-avbilden, /var/lib/jenkins med paketen. Klistra in det på sidan Unlock Jenkins och skapa sedan ditt eget administratörskonto.
Dokumentationen rekommenderar att köra dem på agenter: på den inbyggda noden har ett bygge samma åtkomst till kontrollenhetens filer som Jenkins. Anslut en agent, över SSH eller WebSocket, och sätt sedan den inbyggda nodens exekutorer till 0.
Servera den med HTTPS bakom en omvänd proxy, byt till matrisbaserad säkerhet, reservera Overall/Administer för personer du litar på, låt CSRF-skyddet vara på, kör byggena på agenter och tillämpa snabbt de LTS-versioner som innehåller säkerhetsrättelser.
Arkivera JENKINS_HOME, med tjänsten stoppad eller via en ögonblicksbild av filsystemet. Håll secrets/master.key utanför den säkerhetskopian, förvarad separat på en mycket säker plats, och validera varje säkerhetskopia genom att återställa den på en test-Jenkins som startas på en annan port.
En Managed VPS täcker servern: system, säkerhet, övervakning och säkerhetskopior. Våra team följer också din instans proaktivt och rekommenderar de rättelser som är till nytta, som du genomför själv. Ett ingrepp i själva applikationen faktureras per timme eller som fast pris.
Simafri
Låt oss prata om din webbplats
Berätta om ditt projekt med några ord: vi återkommer snabbt.
Tack! Din förfrågan har skickats. Vi återkommer till dig inom kort.
Föredrar du e-post? Skriv till oss på support@simafri.com.