Ospitare Jenkins® su un VPS gestito: le vostre build sul vostro server

Ospitare Jenkins su un VPS gestito significa compilare, testare e distribuire i vostri progetti da una macchina tutta vostra, che i nostri team tengono aggiornata e supervisionano giorno e notte. Jenkins è un software libero con licenza MIT. Questa guida segue la sua documentazione ufficiale: la scelta della versione LTS, l'installazione con Docker Compose o con i pacchetti Linux, HTTPS e l'URL di Jenkins, gli agenti, i permessi, i plugin, i backup e gli aggiornamenti.

Simon Vasconcelos Lee Di Pubblicato il 16 novembre 2026Lettura: 15 minuti

Tutte le guide

In breve

  1. La licenza MIT consente di usare Jenkins liberamente in azienda, a condizione di conservarne la nota di licenza. Il nome dipende a parte dalla politica sul marchio adottata dal progetto, quella della Linux Foundation.
  2. Scegliete la linea LTS: la 2.580.2 al 28 ottobre 2026, che gira su Java 21 o Java 25. Una nuova base LTS viene scelta ogni 12 settimane.
  3. Installatelo con l'immagine ufficiale jenkins/jenkins e i suoi tag lts, oppure con i pacchetti Linux del progetto, dietro un reverse proxy in HTTPS; impostate poi quell'indirizzo come URL di Jenkins.
  4. Fate girare le build sugli agenti e portate a 0 gli esecutori del controller. Concedete i permessi con la sicurezza a matrice e lasciate attiva la protezione CSRF.
  5. Salvate JENKINS_HOME, conservate a parte secrets/master.key, e leggete la guida all'aggiornamento di ogni LTS prima di applicarla.

Che cosa fa Jenkins

Jenkins si presenta come il principale server di automazione open source. Scritto in Java, offre oltre 2.000 plugin per automatizzare praticamente qualsiasi cosa. Il suo README ne elenca gli usi più comuni: compilare i progetti, eseguire i test per individuare i bug non appena vengono introdotti, l'analisi statica del codice e la distribuzione.

La licenza MIT e il marchio

Jenkins è pubblicato con la licenza MIT. Consente di usare, copiare, modificare, unire, pubblicare, distribuire, concedere in sublicenza e vendere il software, a una condizione: conservare l'avviso di copyright e il testo della licenza in ogni copia. Potete quindi far girare Jenkins in azienda, per i vostri progetti come per quelli dei vostri clienti, senza alcuna licenza da acquistare.

La licenza copre il codice. Il nome «Jenkins» è un marchio registrato di LF Charities, Inc., organizzazione legata alla Linux Foundation, e il progetto applica la politica sul marchio della Linux Foundation. Questa politica riguarda chi inserisce la parola nel nome del proprio prodotto o servizio, e propone a questo scopo forme come «il vostro prodotto for Jenkins»: leggetela se costruite un'offerta attorno al software. Citare Jenkins per descriverlo, come fa questa guida, è un uso corretto.

Questa pubblicazione è indipendente dal progetto Jenkins, da LF Charities, Inc. e dalla Linux Foundation: non è affiliata a essi, né sponsorizzata o approvata da essi.

LTS o settimanale: quale versione installare

Jenkins esce su due linee. La versione settimanale porta ogni settimana novità e correzioni. La linea LTS, per Long-Term Support, parte da una versione settimanale scelta come base ogni 12 settimane, poi riceve correzioni riportate. La documentazione presenta i tag LTS dell'immagine Docker come la versione più stabile, pronta per la produzione: è quella che installa questa guida.

LineaAll'8 novembre 2026Ritmo
LTS2.580.2 del 28 ottobre 2026, dopo la 2.580.1 del 30 settembreTre versioni per base, .1, .2 e .3, ciascuna dopo due settimane di correzioni riportate e due settimane di test
Settimanale2.589Una versione a settimana

La LTS 2.580.2 richiede Java 21 o Java 25: con qualsiasi altra versione, il controller non si avvia. Il progetto prevede di terminare il supporto di Java 21 a settembre 2027, e quello di Java 25 a settembre 2029. Il requisito vale per l'intero sistema, controller, agenti e riga di comando; i vostri progetti, invece, si compilano con la versione di Java più adatta a loro.

L'installazione con Docker Compose

La documentazione raccomanda l'immagine ufficiale jenkins/jenkins. Il tag lts segue la LTS su Java 21, lts-jdk25 la stessa LTS su Java 25, e latest la versione settimanale. Su un server in cui Docker è installato, create una cartella e collocatevi questo compose.yaml, tratto dall'esempio Caddy della documentazione: Caddy riceve i visitatori sulle porte 80 e 443, ottiene il certificato HTTPS e inoltra a Jenkins, raggiungibile solo sulla rete interna.

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
}
Terminale
docker compose up -d

Dimensionare il server

La documentazione fissa un minimo di 256 MB di memoria e 1 GB di disco, almeno 10 GB in un container Docker, e raccomanda 4 GB di memoria o più e 50 GB di disco o più per un piccolo team. Spiega che la memoria del controller va da 200 MB per una piccola installazione a oltre 70 GB per le più grandi; ogni agente connesso vi occupa 2 o 3 thread, circa 2 MB o più. La maggior parte del lavoro, le build, gira sugli agenti.

Su un VPS gestito, parlateci dei vostri progetti e della frequenza delle vostre build: vi raccomandiamo la taglia adatta per il controller e per gli agenti.

Con i pacchetti Debian o Ubuntu

Il progetto pubblica anche pacchetti per Debian e Ubuntu, Fedora, Red Hat Enterprise Linux e le sue derivate. Su Debian o Ubuntu, installate prima Java: la documentazione lo raccomanda vivamente, perché un Jenkins installato prima di Java potrebbe non trovare un'installazione di Java valida all'avvio.

Terminale
sudo apt update
sudo apt install fontconfig openjdk-21-jre
java -version

Aggiungete poi il repository LTS, debian-stable, con la sua chiave di firma, e installate Jenkins:

Terminale
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

Il pacchetto crea un servizio systemd e un utente jenkins, invia il proprio log a journald (journalctl -u jenkins.service), conserva i dati in /var/lib/jenkins e ascolta sulla porta 8080, su tutte le interfacce. Dietro un proxy sullo stesso server, limitatelo all'indirizzo locale con sudo systemctl edit jenkins, poi sudo systemctl restart jenkins:

Override del servizio
[Service]
Environment="JENKINS_LISTEN_ADDRESS=127.0.0.1"

Con Nginx e Certbot

Questo blocco segue l'esempio Nginx della documentazione, ridotto al suo blocco location /, la forma che prevede quando Nginx non legge da sé i file di Jenkins:

Blocco 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 installa poi il certificato e si occupa di rinnovarlo:

Terminale
sudo certbot --nginx

L'URL di Jenkins e il reverse proxy

Una volta online Jenkins, impostate il suo indirizzo pubblico, per esempio https://jenkins.example.com/, in Manage Jenkins, System, nella sezione Jenkins Location. Jenkins lo usa per tutti gli indirizzi che genera, nell'interfaccia come nei file degli agenti, e per comunicare con gli agenti e con gli strumenti esterni. Le opzioni di porta non cambiano nulla: conta questo URL.

Jenkins sorveglia il proprio reverse proxy. Se mostra «It appears that your reverse proxy setup is broken», verificate prima che questo URL corrisponda all'indirizzo che usate, poi che il proxy invii X-Forwarded-Proto quando riceve HTTPS e dialoghi con Jenkins in HTTP, come fanno entrambi gli esempi di questa guida.

Servito in un percorso come /jenkins anziché con un nome di dominio dedicato, Jenkins deve conoscere quel percorso: --prefix=/jenkins, tramite JENKINS_OPTS con Docker o JENKINS_PREFIX con i pacchetti. La documentazione raccomanda lo stesso percorso dalle due parti, perché riscriverlo nel proxy obbliga a correggere moltissimi indirizzi.

Il primo avvio: la password iniziale e la procedura guidata

Al primo accesso, Jenkins chiede una password generata automaticamente, che scrive nel proprio log e in secrets/initialAdminPassword. Aprite il vostro indirizzo HTTPS, poi leggetela:

Terminale, con Docker Compose
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
Terminale, con i pacchetti
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
  1. Incollate questa password nella pagina Unlock Jenkins.
  2. Scegliete Install suggested plugins, l'insieme che la documentazione consiglia quando non sapete ancora di quali plugin avete bisogno; gli altri si aggiungono in seguito in Manage Jenkins, Plugins.
  3. Create il primo amministratore, con una password solida. Se saltate questo passaggio, l'account admin mantiene come password quella di sblocco.
  4. Impostate l'URL di Jenkins, come nella sezione precedente.

La procedura guidata lascia in vigore la strategia di autorizzazione «Logged-in users can do anything»: ogni account connesso ha tutti i diritti. Va bene finché solo persone di piena fiducia hanno un account. Prima di aprire altri account, passate alla sicurezza a matrice, descritta più avanti.

Le build sugli agenti, il controller per orchestrare

Una build esegue comandi controllati da persone diverse dall'amministratore: script di compilazione, test, il codice di ogni commit. Sul nodo integrato, quei comandi hanno sul file system del controller lo stesso accesso di Jenkins stesso. La documentazione raccomanda quindi di non far girare alcuna build sul nodo integrato e di affidarle agli agenti, il che lascia anche la CPU e la memoria del controller al suo lavoro.

  1. Collegate almeno un agente: un'altra macchina, un container o un cloud. L'agente ha bisogno di Java e di una connessione di rete verso il controller.
  2. In Manage Jenkins, Nodes, aprite Built-In Node, poi Configure, e portate a 0 il numero di esecutori. Fatelo una volta che un agente è al suo posto, perché le build attendono allora che un agente parta. L'immagine Docker ne imposta 2 per impostazione predefinita.
ConnessioneComeLato rete
SSHIl controller si collega all'agente, con il plugin SSH Build AgentsNessuna porta da aprire sul controller
WebSocketL'agente si collega al controller tramite il suo indirizzo HTTPS, da Jenkins 2.217Nessuna porta in più: il proxy inoltra WebSocket
TCP in ingressoL'agente si collega al controller su una porta TCP dedicataUna porta fissa da aprire e pubblicare, 50000 nell'immagine Docker

La documentazione consiglia agenti generici e intercambiabili, preparati con uno strumento di gestione della configurazione, un'immagine predisposta o un container: un agente che si guasta si sostituisce allora senza sforzo. Con un solo server, suggerisce un agente che gira con un altro utente del sistema operativo, senza accesso in lettura né in scrittura a JENKINS_HOME e senza sudo. Su un VPS gestito, anche un secondo VPS può fare da agente, dimensionato per le vostre build.

Il controllo di accesso dagli agenti verso il controller, che impedisce a un agente compromesso di inviare comandi al controller, è sempre attivo da Jenkins 2.326.

Gli account e i permessi

Jenkins distingue l'autenticazione, che stabilisce chi siete, dall'autorizzazione, che dice che cosa potete fare. Il suo database di utenti integrato, attivo per impostazione predefinita, si adatta ai piccoli team; LDAP, Active Directory, SAML o OpenID Connect si collegano tramite plugin. Per l'autorizzazione, ecco le strategie che descrive la documentazione:

StrategiaChe cosa concedeQuando sceglierla
Anyone can do anythingTutti i diritti, anche ai visitatori anonimiSolo per una prova in locale
Logged-in users can do anythingTutti i diritti a ogni account connesso; l'impostazione lasciata dalla procedura guidataFinché solo persone di piena fiducia hanno un account
Matrix-based securityPermessi concessi per utente o per gruppoIl punto di partenza che la documentazione raccomanda per la produzione
Project-based Matrix Authorization StrategyLa stessa matrice, estesa progetto per progettoPer riservare alcuni progetti ad alcune persone

Entrambe le strategie a matrice provengono dal plugin Matrix Authorization Strategy, che rientra tra i plugin suggeriti dalla procedura guidata. Nella matrice, concedete poco alle righe anonymous e authenticated: Overall/Administer concesso ad authenticated equivale a «Logged-in users can do anything». Usate la stessa cautela se aprite l'iscrizione libera o un provider di identità in cui chiunque può creare un account.

I plugin e i loro aggiornamenti

I plugin sono ciò che rende Jenkins così versatile, e ognuno è codice che gira all'interno del controller. Jenkins consulta l'Update Center una volta ogni 24 ore; gli aggiornamenti compaiono nella scheda Updates di Manage Jenkins, Plugins, e hanno effetto dopo un riavvio. Il pulsante Check now forza una verifica.

Con Docker, potete anche costruire la vostra immagine a partire da jenkins/jenkins e installarvi i vostri plugin con jenkins-plugin-cli, da un elenco plugins.txt che ne fissa le versioni e che lo strumento sa aggiornare. Il README dell'immagine descrive questo metodo.

Le notifiche via e-mail

Le notifiche delle build passano dal plugin Mailer: una build fallita, una riuscita dopo un fallimento o una build che diventa instabile fa partire un'e-mail. Il server di invio si imposta in Manage Jenkins, System, nella sezione E-mail Notification.

Su un VPS Simafri, l'invio passa da un relay SMTP autenticato, sulla porta 587: l'indirizzo di un account di posta che avete già, oppure Simafri Suite. Nelle opzioni avanzate, spuntate Use SMTP Authentication con il nome utente e la password dell'account, poi Use TLS: il plugin usa allora la porta 587. L'opzione Test configuration by sending test e-mail invia un messaggio di prova.

Il backup di JENKINS_HOME

La documentazione definisce di importanza critica i backup del controller: servono al ripristino dopo un disastro, al recupero di una configurazione modificata per errore, o di un file danneggiato o eliminato. Tutto vive in JENKINS_HOME: /var/jenkins_home nell'immagine Docker, /var/lib/jenkins con i pacchetti.

ElementoChe cosa conservaDa salvare
*.xml, compreso config.xmlLa configurazione principale e quella del sistemaObbligatorio
jobs/I job e la cronologia delle build; in builds/archive, gli artefatti archiviatiObbligatorio; gli artefatti secondo le necessità, diventano voluminosi
plugins/*.jpiI plugin installati, nelle loro versioniRaccomandato, per ripristinare in modo identico
secrets/Le chiavi che cifrano le credenzialiLa cartella, tranne master.key, conservata a parte
workspace/I file estratti dal controllo del codice sorgente per le buildFacoltativo: un nuovo checkout li ricrea
war/, cache/, tools/Il WAR estratto, gli strumenti scaricati ed estrattiFacoltativo: ricreati al bisogno

La documentazione chiede di non mettere mai la chiave principale nel vostro backup abituale. secrets/master.key cifra la chiave che protegge le vostre credenziali: chi possiede i vostri backup e questa chiave può leggere tutto. Copiatela una volta e conservatela a parte in un luogo molto sicuro, come una chiave privata SSH; un ripristino completo ne ha bisogno.

Con Docker Compose

Il README dell'immagine chiede di trattare jenkins_home come un database. Fermate Jenkins per la durata della copia, poi archiviate il volume con un container temporaneo, secondo il metodo della documentazione di Docker:

Terminale, nella cartella del 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
Terminale, una volta: la chiave principale
docker cp jenkins:/var/jenkins_home/secrets/master.key ./master.key

Con i pacchetti

Terminale
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

Una copia fatta a servizio fermo è coerente. Per salvare senza fermare, la documentazione indica gli snapshot del file system, LVM, btrfs o ZFS, più coerenti e più rapidi di una copia a caldo; tra i plugin di backup open source, cita thinBackup come l'unico ancora mantenuto. Date a ogni copia un nome con data e ora, evitate /tmp, che può essere svuotata al riavvio, e inviate le copie terminate a un server remoto.

Collocati sul disco del server, questi archivi rientrano anche nei suoi backup notturni.

Convalidare un backup

La documentazione chiede di convalidare ogni backup, e fornisce il metodo semplice: ripristinatelo in una cartella temporanea, rimettete al suo posto master.key, e avviate su di essa un secondo Jenkins della stessa versione, su un'altra porta:

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

Gli aggiornamenti

Prima di ogni aggiornamento del core, leggete la pagina della LTS di destinazione nelle guide all'aggiornamento del progetto: ogni sezione tratta il passaggio dalla LTS precedente. Per la 2.580.2, non segnala alcuna modifica di rilievo. Per la 2.580.1, segnala che diversi plugin staccati dal core non sono più inclusi nel WAR: Jenkins li installa da solo quando l'Update Center è raggiungibile. Salvate poi JENKINS_HOME e aggiornate:

Terminale, con Docker Compose
docker compose pull
docker compose up -d
Terminale, con i pacchetti
sudo apt update
sudo apt install jenkins

Chi fa che cosa su un VPS gestito

Il self-hosting richiede di occuparsi del server oltre che dell'applicazione. Su un VPS gestito, i nostri team prendono in carico il server e seguono la vostra istanza in modo proattivo; Jenkins resta il vostro software, con le sue pipeline, le sue impostazioni e i suoi dati.

ArgomentoI nostri teamVoi
Il serverAggiornamenti del sistema e della sicurezza, interventi sul server compresiIl momento più adatto alla vostra attività
La supervisioneServer seguito 24 ore su 24, 7 giorni su 7, con intervento senza attendere la vostra chiamataLa lettura dei log della vostra istanza e delle vostre build
JenkinsMonitoraggio proattivo: errori, rallentamenti e spazio su disco individuati, correzione raccomandataLa sua installazione, i suoi aggiornamenti, i suoi plugin e le sue impostazioni, che applicate voi o il vostro assistente IA
Le pipeline e gli agentiI server che li ospitano, sorvegliati e salvatiI job, gli agenti, gli account, i permessi e le credenziali
I backupOgni notte, cifrati e conservati fuori dalla macchina; ripristino compresoGli archivi propri di Jenkins, il file master.key e la richiesta di ripristino, quando ne avete bisogno
La migrazioneIl vostro server attuale migrato, in omaggioIl momento del passaggio

Se preferite che i nostri team intervengano nell'applicazione stessa, questa prestazione si fattura a ore o a forfait, con un preventivo comunicato prima dell'intervento.

Jenkins, su un server gestito per voi

Con un VPS gestito Simafri, i nostri team tengono aggiornato il server della vostra istanza Jenkins, lo sorvegliano giorno e notte e intervengono senza attendere la vostra chiamata; seguono anche la vostra istanza in modo proattivo e vi raccomandano le correzioni utili, che applicate voi o il vostro assistente IA. I backup sono cifrati ogni notte e conservati fuori dalla macchina, il loro ripristino è compreso e la migrazione del vostro server attuale è in omaggio.

Scoprire i VPS gestiti

Domande frequenti

Jenkins è gratuito per un'azienda?

Sì. Jenkins ha licenza MIT: potete usarlo, modificarlo e farlo girare in azienda senza alcuna licenza da acquistare, a condizione di conservarne l'avviso di copyright e la nota di licenza. Resta il costo dei server che ospitano il controller e gli agenti.

Quale versione di Jenkins installare?

La linea LTS, che la documentazione presenta come pronta per la produzione: la 2.580.2 al 28 ottobre 2026. Richiede Java 21 o Java 25. Una nuova base LTS viene scelta ogni 12 settimane, e ogni base riceve tre versioni correttive.

Come installare Jenkins con Docker?

Usate l'immagine ufficiale jenkins/jenkins con un tag LTS, come lts-jdk25, e un volume con nome montato su /var/jenkins_home. Collocate davanti un reverse proxy in HTTPS, per esempio Caddy nello stesso file compose.yaml, poi impostate l'indirizzo pubblico come URL di Jenkins.

Dove si trova la password iniziale dell'amministratore di Jenkins?

Nel log di avvio, e nel file secrets/initialAdminPassword di JENKINS_HOME: /var/jenkins_home con l'immagine Docker, /var/lib/jenkins con i pacchetti. Incollatela nella pagina Unlock Jenkins, poi create il vostro account amministratore.

Le build devono girare sul controller Jenkins?

La documentazione raccomanda di farle girare sugli agenti: sul nodo integrato, una build ha sui file del controller lo stesso accesso di Jenkins. Collegate un agente, in SSH o in WebSocket, poi portate a 0 gli esecutori del nodo integrato.

Come proteggere un'istanza Jenkins?

Servitela in HTTPS dietro un reverse proxy, passate alla sicurezza a matrice, riservate Overall/Administer a persone di fiducia, lasciate attiva la protezione CSRF, fate girare le build sugli agenti e applicate senza indugio le versioni LTS che portano correzioni di sicurezza.

Come fare il backup di Jenkins?

Archiviate JENKINS_HOME, a servizio fermo o tramite uno snapshot del file system. Tenete secrets/master.key fuori da questo backup, conservata a parte in un luogo molto sicuro, e convalidate ogni backup ripristinandolo su un Jenkins di prova avviato su un'altra porta.

Un VPS gestito copre Jenkins?

Un VPS gestito copre il server: sistema, sicurezza, supervisione e backup. I nostri team seguono anche la vostra istanza in modo proattivo e vi raccomandano le correzioni utili, che applicate voi. Un intervento nell'applicazione si fattura a ore o a forfait.

Fonti e documentazione ufficiale

Contattaci