Come installare JupyterLab su Ubuntu 24.04

JupyterLab è un ambiente di sviluppo interattivo basato sul web e open-source che estende l’esperienza classica di Jupyter Notebook, fornendo un’interfaccia più flessibile e potente per le attività di scienza dei dati e calcolo scientifico. Supporta vari linguaggi di programmazione, con un forte focus su Python, e offre funzionalità come editing del codice, visualizzazione dei dati e output interattivo in un’unica area di lavoro integrata. JupyterLab consente agli utenti di creare e gestire notebook, editor di testo, terminali e altri componenti personalizzati in un layout a schede, migliorando la produttività e la collaborazione. Su Ubuntu, può essere facilmente installato tramite gestori di pacchetti come apt o attraverso l’installer di pacchetti di Python pip, rendendolo uno strumento accessibile per sviluppatori e ricercatori che utilizzano questa popolare distribuzione Linux.

In questa guida, imparerai come installare Jupyter su Ubuntu 24.04. Installerai e proteggerai Jupyter con autenticazione tramite password. Poi installerai Nginx e lo configurerai come proxy inverso.

Prerequisiti

Prima di iniziare, assicurati di avere i seguenti requisiti:

• Un Ubuntu 24.04.
• Un utente non root con privilegi di amministratore.
• Un nome di dominio puntato a un indirizzo IP del server (dominio pubblico o privato).

Installazione delle dipendenze

In questa sezione, installerai le dipendenze per Jupyter, che includono Python, Pip, venv e Node.js. Questi pacchetti sono disponibili per impostazione predefinita nel repository di Ubuntu e li installerai tramite il gestore di pacchetti APT.

Per iniziare, esegui il comando qui sotto per aggiornare l’indice dei pacchetti di Ubuntu.

sudo apt update

Ora installa Python3 e Node.js tramite il repository di Ubuntu con il seguente comando - Inserisci Y per confermare l’installazione:

sudo apt install python3-dev python3-pip python3-venv nodejs npm

Dopo che l’installazione è completata, controlla la versione di Python, Node.js e Pip con i seguenti comandi:

python3 -v
pip3 -v
node -v

Puoi vedere qui sotto che Python 3.12, Node.js 18 e Pip 24 sono installati.

Installazione di Jupyter

Dopo aver installato le dipendenze, installerai Jupyter tramite Pip nell’ambiente virtuale Python. Eseguirai Jupyter come utente non root, quindi assicurati di averlo creato.

Accedi al tuo utente con il comando qui sotto - L’esempio seguente utilizzerà l’utente alice:

su - alice

Esegui il comando qui sotto per creare una nuova directory ~/Dev e spostati al suo interno. Poi, crea un nuovo ambiente virtuale Python venv.

mkdir -p ~/Dev; cd ~/Dev
python3 -v venv venv

Ora attiva l’ambiente virtuale venv con il seguente comando. Una volta attivato, il tuo shell diventerà simile a (venv) user@hostname.

source venv/bin/activate

Successivamente, esegui il comando pip3 qui sotto per installare Jupyter tramite il repository PyPi:

pip3 install jupyter

Qui sotto puoi vedere l’installazione di jupyter tramite il comando pip3:

Dopo che il processo è terminato, controlla la versione di Jupyter con il seguente comando:

jupyter –version

Vedrai la versione di ciascun componente di Jupyter, come jupyterlab, jupyter_server, jupyter_client, jupyter_core e iPython.

Configurazione di Jupyter

In questa sezione, configurerai due componenti principali di Jupyter, che sono jupyter_server e jupyterlab. Genererai la configurazione e imposterai l’autenticazione tramite password per entrambi i componenti. Poi, eseguirai Jupyter tramite la riga di comando.

Per prima cosa, esegui il comando jupyter qui sotto per generare la configurazione di jupyter_server e la password. Inserisci la tua password quando richiesto e ripetila.

jupyter server –generate-config
jupyter server password

Puoi vedere qui sotto che la configurazione di jupyter_server è stata generata in ~/.jupyter/jupyter_server_config.py, e il file della password è scritto in ~/.jupyter/jupyter_server_config.json.

Controlla la configurazione di jupyter_server con il comando qui sotto.

jupyter server –show-config

E vedrai un output simile al seguente:

Successivamente, esegui il comando jupyter qui sotto per generare la configurazione di jupyterlab in ~/.jupyter/jupyter_lab_config.py. Poi, controlla la configurazione di jupyterlab.

jupyter lab –generate-config
jupyter lab –show-config

Nell’output seguente, il percorso URL predefinito per jupyterlab è /lab.

Ora esegui il comando jupyter qui sotto per avviare jupyterlab dalla riga di comando. Il jupyterlab dovrebbe essere in esecuzione sulla porta 8888 e il percorso URL lab.

jupyter lab –ip 0.0.0.0

Visita http://server-ip:8888/lab per accedere alla tua installazione di jupyterlab. Vedrai il seguente dashboard di Jupyter.

Ora premi Ctrl+c e digita yes per terminare il processo di jupyterlab.

Esecuzione di JupyterLab come servizio

In questa guida, eseguirai Jupyter in background come servizio. Quindi ora devi creare un nuovo file di servizio systemd per Jupyter.

Crea un nuovo file di servizio systemd /etc/systemd/system/jupyterlab.service con il seguente comando dell’editor nano.

sudo nano /etc/systemd/system/jupyterlab.service

Inserisci la seguente configurazione e assicurati di cambiare l’utente alice con il tuo nome utente.

[Unit]
Description=Servizio JupyterLab

[Service]
Type=simple
PIDFile=/run/jupyter.pid
ExecStart=/home/alice/Dev/venv/bin/jupyter lab --config=/home/alice/.jupyter/jupyter_lab_config.py
User=alice
Group=alice
WorkingDirectory=/home/alice/Dev
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Salva il file ed esci dall’editor quando hai finito.

Ora esegui il comando qui sotto per ricaricare il gestore systemd e attivare il tuo nuovo file di servizio.

sudo systemctl daemon-reload

Successivamente, avvia e abilita il servizio jupyterlab con il comando qui sotto.

sudo systemctl start jupyterlab
sudo systemctl enable jupyterlab

Infine, esegui il comando qui sotto per controllare lo stato del servizio jupyterlab. Vedrai che il servizio jupyterlab è in esecuzione e abilitato sul tuo sistema.

sudo systemctl status jupyterlab

Consentire l’accesso remoto a Jupyter

Prima di configurare Nginx come proxy inverso, devi consentire l’accesso remoto su jupyterlab. Ora modificherai il file ~/.jupyter/jupyter_lab_config.py e abiliterai l’accesso remoto.

Per prima cosa, apri la configurazione di jupyterlab ~/.jupyter/jupyter_lab_config.py con il seguente editor nano.

nano ~/.jupyter/jupyter_lab_config.py

Decommenta l’opzione c.ServerApp.allow_remote_access e cambiala in True. Questo abiliterà l’accesso remoto per jupyterlab.

c.ServerApp.allow_remote_access = True

Salva ed esci dal file quando hai finito.

Ora esegui il comando qui sotto per riavviare il servizio jupyterlab e applicare le tue modifiche. Dopo che l’accesso remoto è abilitato in Jupyter, verrà generato un nuovo token per impostare una password.

sudo systemctl restart jupyterlab

Dai un’occhiata in fondo al messaggio e copia il token generato per Jupyter.

Configurazione di Nginx come proxy inverso

In questa sezione, installerai e configurerai Nginx come proxy inverso per la tua installazione di Jupyter. Quindi assicurati di avere il tuo nome di dominio, sia esso pubblico o privato.

Installa il server web Nginx con il comando qui sotto - Inserisci Y per procedere con l’installazione.

sudo apt install nginx

Dopo che l’installazione è completata, crea una nuova configurazione del blocco server Nginx /etc/nginx/sites-available/jupyterlab con il seguente editor nano.

sudo nano /etc/nginx/sites-available/jupyterlab

Aggiungi la seguente configurazione al file e assicurati di cambiare il nome di dominio all’interno dell’opzione server_name.

server {
    listen 80;
    server_name lab.howtoforge.local;

    access_log /var/log/nginx/howtoforge.local.access.log;
    error_log /var/log/nginx/howtoforge.local.error.log;

    location / {
        proxy_pass http://127.0.0.1:8888;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header Host $http_host;
        proxy_http_version 1.1;
        proxy_redirect off;
        proxy_buffering off;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_read_timeout 86400;
    }
}

Quando hai finito, salva ed esci dal file.

Ora esegui il comando qui sotto per attivare il blocco server jupyterlab e verificare la sintassi di Nginx. Se hai la configurazione corretta, riceverai un output syntax is ok ... test is successful.

sudo ln -s /etc/nginx/sites-available/jupyterlab /etc/nginx/sites-enabled/
sudo nginx -t

Infine, esegui il comando qui sotto per riavviare Nginx e applicare la tua nuova configurazione del blocco server jupyterlab. Dopo che il comando è stato eseguito, il tuo Jupyter è in esecuzione sotto il proxy inverso Nginx.

sudo systemctl restart nginx

Accesso a Jupyter

Se stai usando Linux o MacOS, modifica il file /etc/hosts. Per gli utenti Windows, modifica il file C:\System32\drivers\etc\hosts come amministratore.

Aggiungi il tuo indirizzo IP del server e il nome di dominio Jupyter come segue:

192.168.5.65 lab.howtoforge.local

Salva ed esci dal file.

Ora apri il tuo browser web e visita il tuo nome di dominio Jupyter come http://lab.howtoforge.local/. Se la tua configurazione ha avuto successo, vedrai la pagina di accesso di Jupyter.

Scorri fino in fondo e incolla il token per la tua installazione di Jupyter. Poi, inserisci la nuova password per Jupyter e clicca su Accedi e imposta nuova password.

Se tutto è andato a buon fine, vedrai il dashboard di Jupyter come il seguente - E la tua password per Jupyter è stata anche cambiata.

Conclusione

Congratulazioni! Hai completato l’installazione di Jupyter su Ubuntu 24.04. Ora hai Jupyter in esecuzione con Nginx come proxy inverso e protetto con autenticazione tramite password. Se stai eseguendo Jupyter su un server pubblico o VPS (Virtual Private Server), devi implementare HTTPS sopra il tuo proxy inverso Nginx. Puoi ottenere ciò tramite Certbot e Letsencrypt.