Hosta Jenkins® på en Managed VPS: dina byggen på din egen server

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.

Simon Vasconcelos Lee Av Publicerad den 16 november 2026Lästid: 15 minuter

Alla guider

I korthet

  1. MIT-licensen tillåter fri användning av Jenkins i ditt företag, så länge du behåller dess licensmeddelande. Namnet omfattas separat av den varumärkespolicy som projektet har antagit, Linux Foundations.
  2. Välj LTS-linjen: 2.580.2 den 28 oktober 2026, som körs på Java 21 eller Java 25. En ny LTS-bas väljs var tolfte vecka.
  3. Installera med den officiella avbilden jenkins/jenkins och dess taggar lts, eller med projektets Linuxpaket, bakom en omvänd proxy med HTTPS; ange sedan den adressen som Jenkins-URL.
  4. Kör byggena på agenter och sätt kontrollenhetens exekutorer till 0. Dela ut behörigheter med matrisbaserad säkerhet och låt CSRF-skyddet vara på.
  5. Säkerhetskopiera JENKINS_HOME, förvara secrets/master.key separat och läs uppgraderingsguiden för varje LTS innan du tillämpar den.

Det Jenkins gör

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.

MIT-licensen och varumärket

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.

LTS eller veckoversion: vilken version du ska installera

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.

LinjeDen 8 november 2026Takt
LTS2.580.2 från den 28 oktober 2026, efter 2.580.1 från den 30 septemberTre versioner per bas, .1, .2 och .3, var och en efter två veckors tillbakaföring och två veckors tester
Veckoversion2.589En 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.

Installationen med Docker Compose

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.

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

Dimensionera servern

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.

Med paketen för Debian eller Ubuntu

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.

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

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

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:

Åsidosättning av tjänsten
[Service]
Environment="JENKINS_LISTEN_ADDRESS=127.0.0.1"

Med Nginx och Certbot

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:

Nginx-block
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 installerar sedan certifikatet och sköter förnyelsen:

Terminal
sudo certbot --nginx

Jenkins-URL:en och den omvända proxyn

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.

Den första starten: det initiala lösenordet och installationsguiden

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:

Terminal, med Docker Compose
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
Terminal, med paketen
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
  1. Klistra in lösenordet på sidan Unlock Jenkins.
  2. Välj Install suggested plugins, den uppsättning som dokumentationen råder till när du ännu inte vet vilka insticksprogram du behöver; andra läggs till senare under Manage Jenkins, Plugins.
  3. Skapa den första administratören, med ett starkt lösenord. Om du hoppar över steget behåller kontot admin upplåsningslösenordet som sitt lösenord.
  4. Ange Jenkins-URL:en, som i föregående avsnitt.

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.

Byggena på agenter, kontrollenheten för att samordna

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.

  1. Anslut minst en agent: en annan maskin, en container eller ett moln. Agenten behöver Java och en nätverksanslutning till kontrollenheten.
  2. Under Manage Jenkins, Nodes, öppnar du Built-In Node, sedan Configure, och sätter antalet exekutorer till 0. Gör det när en agent är på plats, eftersom byggena då väntar på att en agent startar. Docker-avbilden sätter 2 som standard.
AnslutningHurPå nätverkssidan
SSHKontrollenheten ansluter till agenten, med insticksprogrammet SSH Build AgentsIngen port att öppna på kontrollenheten
WebSocketAgenten ansluter till kontrollenheten via dess HTTPS-adress, sedan Jenkins 2.217Ingen extra port: proxyn vidarebefordrar WebSocket
Inkommande TCPAgenten ansluter till kontrollenheten på en dedikerad TCP-portEn 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.

Konton och behörigheter

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:

StrategiVad den gerNär den ska väljas
Anyone can do anythingFullständiga rättigheter, även till anonyma besökareBara för ett lokalt test
Logged-in users can do anythingFullständiga rättigheter till varje inloggat konto; den inställning som guiden lämnarSå länge bara personer du litar helt på har ett konto
Matrix-based securityBehörigheter som ges per användare eller per gruppDen utgångspunkt som dokumentationen rekommenderar för produktion
Project-based Matrix Authorization StrategySamma matris, utökad projekt för projektFö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.

Insticksprogrammen och deras uppdateringar

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.

Aviseringar via e-post

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.

Säkerhetskopiera JENKINS_HOME

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.

DelVad den innehållerAtt säkerhetskopiera
*.xml, inklusive config.xmlHuvudkonfigurationen och systemkonfigurationenObligatoriskt
jobs/Jobben och bygghistoriken; i builds/archive, de arkiverade artefakternaObligatoriskt; artefakterna efter behov, de blir stora
plugins/*.jpiDe installerade insticksprogrammen, i sina versionerRekommenderas, för att återställa identiskt
secrets/Nycklarna som krypterar inloggningsuppgifternaMappen, utom master.key, som förvaras separat
workspace/Filerna som hämtats från versionshanteringen för byggenaValfritt: en ny utcheckning skapar dem på nytt
war/, cache/, tools/Den uppackade WAR-filen, nedladdade och uppackade verktygValfritt: 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.

Med Docker Compose

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:

Terminal, i mappen med 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, en gång: huvudnyckeln
docker cp jenkins:/var/jenkins_home/secrets/master.key ./master.key

Med paketen

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

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.

Validera en säkerhetskopia

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:

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

Uppgraderingarna

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:

Terminal, med Docker Compose
docker compose pull
docker compose up -d
Terminal, med paketen
sudo apt update
sudo apt install jenkins

Vem gör vad på en Managed VPS

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ådeVåra teamDu
ServernUppdateringar av system och säkerhet, ingrepp på servern inräknadeTidpunkten som passar din verksamhet
ÖvervakningenServern följs dygnet runt, alla dagar, med ingrepp utan att vänta på ditt samtalLäsningen av din instans och dina byggens loggar
JenkinsProaktiv uppföljning: fel, långsamma svarstider och diskutrymme upptäcks, med rekommenderad rättelseInstallationen, uppdateringarna, insticksprogrammen och inställningarna, som du genomför själv eller med din AI-assistent
Pipelines och agenterServrarna som bär dem, övervakade och säkerhetskopieradeJobben, agenterna, kontona, behörigheterna och inloggningsuppgifterna
SäkerhetskopiornaVarje natt, krypterade och förvarade utanför maskinen; återställning ingårJenkins egna arkiv, filen master.key och begäran om återställning, när du behöver den
MigreringenDin nuvarande server migreras kostnadsfrittTidpunkten 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.

Jenkins, på en server som sköts åt dig

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.

Upptäck Managed VPS

Vanliga frågor

Är Jenkins gratis för ett företag?

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.

Vilken version av Jenkins ska man installera?

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.

Hur installerar man Jenkins med Docker?

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.

Var hittar man Jenkins initiala administratörslösenord?

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.

Ska byggena köras på Jenkins kontrollenhet?

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.

Hur skyddar man en Jenkins-instans?

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.

Hur säkerhetskopierar man Jenkins?

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.

Täcker en Managed VPS Jenkins?

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.

Källor och officiell dokumentation

Kontakta oss