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.
Di Simon Vasconcelos Lee
Pubblicato il 16 novembre 2026Lettura: 15 minuti
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.JENKINS_HOME, conservate a parte secrets/master.key, e leggete la guida all'aggiornamento di ogni LTS prima di applicarla.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.
Jenkinsfile, che la documentazione raccomanda di versionare nel sistema di controllo del codice sorgente del progetto.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.
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.
| Linea | All'8 novembre 2026 | Ritmo |
|---|---|---|
| LTS | 2.580.2 del 28 ottobre 2026, dopo la 2.580.1 del 30 settembre | Tre versioni per base, .1, .2 e .3, ciascuna dopo due settimane di correzioni riportate e due settimane di test |
| Settimanale | 2.589 | Una 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.
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.
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: tutti i dati vivono lì, plugin e configurazione compresi. Il README dell'immagine preferisce questo volume a una cartella dell'host, che può causare problemi di permessi: l'utente jenkins del container ha l'ID 1000.web. La porta 50000 serve agli agenti TCP in ingresso; gli agenti WebSocket e SSH ne fanno a meno, quindi qui non è pubblicata.2.580.2-lts-jdk25 fissa la versione, mentre lts-jdk25 segue la LTS corrente.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.
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.
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:
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:
[Service]
Environment="JENKINS_LISTEN_ADDRESS=127.0.0.1"
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:
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 senza barra finale: la documentazione avverte che terminare questo valore con una barra causa problemi.Upgrade e Connection servono agli agenti WebSocket, e la map mantiene attive le connessioni per il resto del traffico.proxy_request_buffering off è necessario per i comandi della riga di comando di Jenkins inviati in HTTP.client_max_body_size fissa la dimensione massima di un caricamento, 10 MB nell'esempio.Certbot installa poi il certificato e si occupa di rinnovarlo:
sudo certbot --nginx
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.
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:
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
admin mantiene come password quella di sblocco.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.
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.
| Connessione | Come | Lato rete |
|---|---|---|
| SSH | Il controller si collega all'agente, con il plugin SSH Build Agents | Nessuna porta da aprire sul controller |
| WebSocket | L'agente si collega al controller tramite il suo indirizzo HTTPS, da Jenkins 2.217 | Nessuna porta in più: il proxy inoltra WebSocket |
| TCP in ingresso | L'agente si collega al controller su una porta TCP dedicata | Una 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.
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:
| Strategia | Che cosa concede | Quando sceglierla |
|---|---|---|
| Anyone can do anything | Tutti i diritti, anche ai visitatori anonimi | Solo per una prova in locale |
| Logged-in users can do anything | Tutti i diritti a ogni account connesso; l'impostazione lasciata dalla procedura guidata | Finché solo persone di piena fiducia hanno un account |
| Matrix-based security | Permessi concessi per utente o per gruppo | Il punto di partenza che la documentazione raccomanda per la produzione |
| Project-based Matrix Authorization Strategy | La stessa matrice, estesa progetto per progetto | Per 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.
JENKINS_HOME con le chiavi della cartella secrets, che la sezione sui backup tratta a parte.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 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.
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.
| Elemento | Che cosa conserva | Da salvare |
|---|---|---|
*.xml, compreso config.xml | La configurazione principale e quella del sistema | Obbligatorio |
jobs/ | I job e la cronologia delle build; in builds/archive, gli artefatti archiviati | Obbligatorio; gli artefatti secondo le necessità, diventano voluminosi |
plugins/*.jpi | I plugin installati, nelle loro versioni | Raccomandato, per ripristinare in modo identico |
secrets/ | Le chiavi che cifrano le credenziali | La cartella, tranne master.key, conservata a parte |
workspace/ | I file estratti dal controllo del codice sorgente per le build | Facoltativo: un nuovo checkout li ricrea |
war/, cache/, tools/ | Il WAR estratto, gli strumenti scaricati ed estratti | Facoltativo: 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.
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:
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
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.
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:
export JENKINS_HOME=/mnt/backup-test
java -jar jenkins.war --httpPort=9999
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:
docker compose pull
docker compose up -d
sudo apt update
sudo apt install jenkins
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.
| Argomento | I nostri team | Voi |
|---|---|---|
| Il server | Aggiornamenti del sistema e della sicurezza, interventi sul server compresi | Il momento più adatto alla vostra attività |
| La supervisione | Server seguito 24 ore su 24, 7 giorni su 7, con intervento senza attendere la vostra chiamata | La lettura dei log della vostra istanza e delle vostre build |
| Jenkins | Monitoraggio proattivo: errori, rallentamenti e spazio su disco individuati, correzione raccomandata | La sua installazione, i suoi aggiornamenti, i suoi plugin e le sue impostazioni, che applicate voi o il vostro assistente IA |
| Le pipeline e gli agenti | I server che li ospitano, sorvegliati e salvati | I job, gli agenti, gli account, i permessi e le credenziali |
| I backup | Ogni notte, cifrati e conservati fuori dalla macchina; ripristino compreso | Gli archivi propri di Jenkins, il file master.key e la richiesta di ripristino, quando ne avete bisogno |
| La migrazione | Il vostro server attuale migrato, in omaggio | Il 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.
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.
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.
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.
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.
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.
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.
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.
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 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.
Simafri
Parliamo del vostro progetto
Diteci in due parole ciò che vi serve: vi rispondiamo rapidamente.
Grazie! La tua richiesta è stata inviata. Ti risponderemo a breve.
Preferite l'email? Scriveteci a support@simafri.com.