Comment installer JupyterLab sur Ubuntu 24.04

JupyterLab est un environnement de développement interactif basé sur le web et open-source qui étend l’expérience classique de Jupyter Notebook, offrant une interface plus flexible et puissante pour les tâches de science des données et de calcul scientifique. Il prend en charge divers langages de programmation, avec un fort accent sur Python, et propose des fonctionnalités telles que l’édition de code, la visualisation de données et la sortie interactive dans un espace de travail intégré. JupyterLab permet aux utilisateurs de créer et de gérer des notebooks, des éditeurs de texte, des terminaux et d’autres composants personnalisés dans une disposition par onglets, améliorant ainsi la productivité et la collaboration. Sur Ubuntu, il peut être facilement installé via des gestionnaires de paquets comme apt ou via l’installateur de paquets Python pip, ce qui en fait un outil accessible pour les développeurs et les chercheurs utilisant cette distribution Linux populaire.

Dans ce guide, vous apprendrez à installer Jupyter sur Ubuntu 24.04. Vous installerez et sécuriserez Jupyter avec une authentification par mot de passe. Ensuite, vous installerez Nginx et le configurerez en tant que proxy inverse.

Prérequis

Avant de commencer, assurez-vous d’avoir les exigences suivantes :

• Un Ubuntu 24.04.
• Un utilisateur non-root avec des privilèges d’administrateur.
• Un nom de domaine pointant vers une adresse IP de serveur (domaine public ou privé).

Installation des dépendances

Dans cette section, vous installerez les dépendances pour Jupyter, qui incluent Python, Pip, venv et Node.js. Ces paquets sont disponibles par défaut dans le dépôt Ubuntu, et vous les installerez via le gestionnaire de paquets APT.

Pour commencer, exécutez la commande ci-dessous pour mettre à jour l’index des paquets Ubuntu.

sudo apt update

Maintenant, installez Python3 et Node.js via le dépôt Ubuntu avec la commande suivante - Entrez Y pour confirmer l’installation :

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

Après l’installation, vérifiez la version de Python, Node.js et Pip avec les commandes suivantes :

python3 -v
pip3 -v
node -v

Vous pouvez voir ci-dessous que Python 3.12, Node.js 18 et Pip 24 sont installés.

Installation de Jupyter

Après avoir installé les dépendances, vous installerez Jupyter via Pip dans l’environnement virtuel Python. Vous exécuterez Jupyter en tant qu’utilisateur non-root, alors assurez-vous de l’avoir créé.

Connectez-vous à votre utilisateur avec la commande ci-dessous - L’exemple suivant utilisera l’utilisateur alice :

su - alice

Exécutez la commande ci-dessous pour créer un nouveau répertoire ~/Dev et y accéder. Ensuite, créez un nouvel environnement virtuel Python venv.

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

Maintenant, activez l’environnement virtuel venv avec la commande suivante. Une fois activé, votre shell ressemblera à (venv) user@hostname.

source venv/bin/activate

Ensuite, exécutez la commande pip3 ci-dessous pour installer Jupyter via le dépôt PyPi :

pip3 install jupyter

Ci-dessous, vous pouvez voir l’installation de jupyter via la commande pip3 :

Après la fin du processus, vérifiez la version de Jupyter avec la commande suivante :

jupyter –version

Vous verrez la version de chaque composant de Jupyter, tel que jupyterlab, jupyter_server, jupyter_client, jupyter_core et iPython.

Configuration de Jupyter

Dans cette section, vous configurerez deux composants principaux de Jupyter, qui sont jupyter_server et jupyterlab. Vous générerez une configuration et configurerez l’authentification par mot de passe pour les deux composants. Ensuite, vous exécuterez Jupyter via la ligne de commande.

Tout d’abord, exécutez la commande jupyter ci-dessous pour générer la configuration jupyter_server et le mot de passe. Entrez votre mot de passe lorsqu’on vous le demande et répétez.

jupyter server –generate-config
jupyter server password

Vous pouvez voir ci-dessous que la configuration jupyter_server est générée dans ~/.jupyter/jupyter_server_config.py, et le fichier de mot de passe est écrit dans ~/.jupyter/jupyter_server_config.json.

Vérifiez la configuration jupyter_server avec la commande ci-dessous.

jupyter server –show-config

Et vous verrez une sortie similaire à la suivante :

Ensuite, exécutez la commande jupyter ci-dessous pour générer la configuration jupyterlab dans ~/.jupyter/jupyter_lab_config.py. Ensuite, vérifiez la configuration jupyterlab.

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

Dans la sortie suivante, le chemin d’URL par défaut pour jupyterlab est /lab.

Maintenant, exécutez la commande jupyter ci-dessous pour démarrer jupyterlab depuis la ligne de commande. Le jupyterlab devrait fonctionner sur le port 8888 et le chemin d’URL lab.

jupyter lab –ip 0.0.0.0

Visitez http://server-ip:8888/lab pour accéder à votre installation de jupyterlab. Vous verrez le tableau de bord Jupyter suivant.

Maintenant, appuyez sur Ctrl+c et tapez yes pour terminer le processus jupyterlab.

Exécution de JupyterLab en tant que service

Dans ce guide, vous exécuterez Jupyter en arrière-plan en tant que service. Vous devez maintenant créer un nouveau fichier de service systemd pour Jupyter.

Créez un nouveau fichier de service systemd /etc/systemd/system/jupyterlab.service avec la commande suivante dans l’éditeur nano.

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

Entrez la configuration suivante et assurez-vous de changer l’utilisateur alice par votre nom d’utilisateur.

[Unit]
Description=Service 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

Enregistrez le fichier et quittez l’éditeur une fois terminé.

Maintenant, exécutez la commande ci-dessous pour recharger le gestionnaire systemd et activer votre nouveau fichier de service.

sudo systemctl daemon-reload

Ensuite, démarrez et activez le service jupyterlab avec la commande ci-dessous.

sudo systemctl start jupyterlab
sudo systemctl enable jupyterlab

Enfin, exécutez la commande ci-dessous pour vérifier l’état du service jupyterlab. Vous verrez que le service jupyterlab est en cours d’exécution et activé sur votre système.

sudo systemctl status jupyterlab

Autoriser l’accès à distance à Jupyter

Avant de configurer Nginx en tant que proxy inverse, vous devez autoriser l’accès à distance sur le jupyterlab. Vous allez maintenant modifier le fichier ~/.jupyter/jupyter_lab_config.py et activer l’accès à distance.

Tout d’abord, ouvrez la configuration jupyterlab ~/.jupyter/jupyter_lab_config.py avec l’éditeur nano suivant.

nano ~/.jupyter/jupyter_lab_config.py

Décommentez l’option c.ServerApp.allow_remote_access et changez-la en True. Cela activera l’accès à distance pour jupyterlab.

c.ServerApp.allow_remote_access = True

Enregistrez et quittez le fichier une fois terminé.

Maintenant, exécutez la commande ci-dessous pour redémarrer le service jupyterlab et appliquer vos modifications. Après que l’accès à distance soit activé dans Jupyter, un nouveau jeton pour configurer un mot de passe sera généré.

sudo systemctl restart jupyterlab

Regardez le bas du message et copiez le jeton généré pour Jupyter.

Configuration de Nginx en tant que proxy inverse

Dans cette section, vous installerez et configurerez Nginx en tant que proxy inverse pour votre installation de Jupyter. Assurez-vous d’avoir votre nom de domaine, qu’il soit public ou privé.

Installez le serveur web Nginx avec la commande ci-dessous - Entrez Y pour procéder à l’installation.

sudo apt install nginx

Après l’installation, créez une nouvelle configuration de bloc serveur Nginx /etc/nginx/sites-available/jupyterlab avec l’éditeur nano suivant.

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

Ajoutez la configuration suivante au fichier et assurez-vous de changer le nom de domaine dans l’option 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;
    }
}

Une fois terminé, enregistrez et quittez le fichier.

Maintenant, exécutez la commande ci-dessous pour activer le bloc serveur jupyterlab et vérifier votre syntaxe Nginx. Si vous avez la bonne configuration, vous obtiendrez une sortie syntax is ok ... test is successful.

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

Enfin, exécutez la commande ci-dessous pour redémarrer Nginx et appliquer votre nouvelle configuration de bloc serveur jupyterlab. Après l’exécution de la commande, votre Jupyter fonctionne sous le proxy inverse Nginx.

sudo systemctl restart nginx

Accéder à Jupyter

Si vous utilisez Linux ou MacOS, éditez le fichier /etc/hosts. Pour les utilisateurs de Windows, éditez le fichier C:\System32\drivers\etc\hosts en tant qu’administrateur.

Ajoutez votre adresse IP de serveur et le nom de domaine Jupyter comme suit :

192.168.5.65 lab.howtoforge.local

Enregistrez et quittez le fichier.

Maintenant, ouvrez votre navigateur web et visitez votre nom de domaine Jupyter tel que http://lab.howtoforge.local/. Si votre configuration est réussie, vous verrez la page de connexion Jupyter.

Faites défiler vers le bas et collez le jeton pour votre installation Jupyter. Ensuite, saisissez le nouveau mot de passe pour Jupyter et cliquez sur Se connecter et définir un nouveau mot de passe.

Si cela réussit, vous verrez le tableau de bord Jupyter comme suit - Et votre mot de passe pour Jupyter a également changé.

Conclusion

Félicitations ! Vous avez terminé l’installation de Jupyter sur Ubuntu 24.04. Vous avez maintenant Jupyter fonctionnant avec Nginx en tant que proxy inverse et sécurisé avec une authentification par mot de passe. Si vous exécutez Jupyter sur un serveur public ou un VPS (Serveur Privé Virtuel), vous devez mettre en œuvre HTTPS au-dessus de votre proxy inverse Nginx. Vous pouvez y parvenir via Certbot et Letsencrypt.