Cómo instalar JupyterLab en Ubuntu 24.04

JupyterLab es un entorno de desarrollo interactivo basado en la web y de código abierto que amplía la experiencia clásica de Jupyter Notebook, proporcionando una interfaz más flexible y poderosa para tareas de ciencia de datos y computación científica. Soporta varios lenguajes de programación, con un fuerte enfoque en Python, y ofrece características como edición de código, visualización de datos y salida interactiva en un único espacio de trabajo integrado. JupyterLab permite a los usuarios crear y gestionar cuadernos, editores de texto, terminales y otros componentes personalizados en un diseño de pestañas, mejorando la productividad y la colaboración. En Ubuntu, se puede instalar fácilmente a través de gestores de paquetes como apt o mediante el instalador de paquetes de Python pip, lo que lo convierte en una herramienta accesible para desarrolladores e investigadores que utilizan esta popular distribución de Linux.

En esta guía, aprenderás a instalar Jupyter en Ubuntu 24.04. Instalarás y asegurarás Jupyter con autenticación por contraseña. Luego, instalarás Nginx y lo configurarás como un proxy inverso.

Requisitos previos

Antes de comenzar, asegúrate de tener los siguientes requisitos:

• Un Ubuntu 24.04.
• Un usuario no root con privilegios de administrador.
• Un nombre de dominio apuntando a una dirección IP del servidor (dominio público o privado).

Instalando dependencias

En esta sección, instalarás las dependencias para Jupyter, que incluyen Python, Pip, venv y Node.js. Estos paquetes están disponibles por defecto en el repositorio de Ubuntu, y los instalarás a través del gestor de paquetes APT.

Para comenzar, ejecuta el siguiente comando para actualizar el índice de paquetes de Ubuntu.

sudo apt update

Ahora instala Python3 y Node.js a través del repositorio de Ubuntu con el siguiente comando - Ingresa Y para confirmar la instalación:

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

Después de que la instalación esté completa, verifica la versión de Python, Node.js y Pip con los siguientes comandos:

python3 -v
pip3 -v
node -v

Puedes ver a continuación que Python 3.12, Node.js 18 y Pip 24 están instalados.

Instalando Jupyter

Después de instalar las dependencias, instalarás Jupyter a través de Pip en el entorno virtual de Python. Ejecutarás Jupyter como un usuario no root, así que asegúrate de haberlo creado.

Inicia sesión en tu usuario con el siguiente comando - El siguiente ejemplo utilizará el usuario alice:

su - alice

Ejecuta el siguiente comando para crear un nuevo directorio ~/Dev y moverte a él. Luego, crea un nuevo entorno virtual de Python venv.

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

Ahora activa el entorno virtual venv con el siguiente comando. Una vez activado, tu terminal se verá como (venv) user@hostname.

source venv/bin/activate

A continuación, ejecuta el comando pip3 a continuación para instalar Jupyter a través del repositorio de PyPi:

pip3 install jupyter

A continuación, puedes ver la instalación de jupyter a través del comando pip3:

Después de que el proceso haya terminado, verifica la versión de Jupyter con el siguiente comando:

jupyter –version

Verás la versión de cada componente de Jupyter, como jupyterlab, jupyter_server, jupyter_client, jupyter_core e iPython.

Configurando Jupyter

En esta sección, configurarás dos componentes principales de Jupyter, que son jupyter_server y jupyterlab. Generarás la configuración y configurarás la autenticación por contraseña para ambos componentes. Luego, ejecutarás Jupyter a través de la línea de comandos.

Primero, ejecuta el comando jupyter a continuación para generar la configuración de jupyter_server y la contraseña. Ingresa tu contraseña cuando se te pida y repítela.

jupyter server –generate-config
jupyter server password

Puedes ver a continuación que la configuración de jupyter_server se genera en ~/.jupyter/jupyter_server_config.py, y el archivo de contraseña se escribe en ~/.jupyter/jupyter_server_config.json.

Verifica la configuración de jupyter_server con el siguiente comando.

jupyter server –show-config

Y verás una salida similar a la siguiente:

A continuación, ejecuta el comando jupyter a continuación para generar la configuración de jupyterlab en ~/.jupyter/jupyter_lab_config.py. Luego, verifica la configuración de jupyterlab.

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

En la siguiente salida, la ruta URL predeterminada para jupyterlab es /lab.

Ahora ejecuta el comando jupyter a continuación para iniciar jupyterlab desde la línea de comandos. El jupyterlab debería estar ejecutándose en el puerto 8888 y la ruta URL lab.

jupyter lab –ip 0.0.0.0

Visita http://server-ip:8888/lab para acceder a tu instalación de jupyterlab. Verás el siguiente panel de Jupyter.

Ahora presiona Ctrl+c y escribe yes para terminar el proceso de jupyterlab.

Ejecutando JupyterLab como un servicio

En esta guía, ejecutarás Jupyter en segundo plano como un servicio. Así que ahora necesitas crear un nuevo archivo de servicio systemd para Jupyter.

Crea un nuevo archivo de servicio systemd /etc/systemd/system/jupyterlab.service con el siguiente comando del editor nano.

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

Ingresa la siguiente configuración y asegúrate de cambiar el usuario alice por tu nombre de usuario.

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

Guarda el archivo y sal del editor cuando termines.

Ahora ejecuta el siguiente comando para recargar el gestor systemd y activar tu nuevo archivo de servicio.

sudo systemctl daemon-reload

A continuación, inicia y habilita el servicio jupyterlab con el siguiente comando.

sudo systemctl start jupyterlab
sudo systemctl enable jupyterlab

Por último, ejecuta el siguiente comando para verificar el estado del servicio jupyterlab. Verás que el servicio jupyterlab está en ejecución y habilitado en tu sistema.

sudo systemctl status jupyterlab

Permitiendo acceso remoto a Jupyter

Antes de configurar Nginx como un proxy inverso, necesitas permitir el acceso remoto en el jupyterlab. Ahora modificarás el archivo ~/.jupyter/jupyter_lab_config.py y habilitarás el acceso remoto.

Primero, abre la configuración de jupyterlab ~/.jupyter/jupyter_lab_config.py con el siguiente editor nano.

nano ~/.jupyter/jupyter_lab_config.py

Descomenta la opción c.ServerApp.allow_remote_access y cámbiala a True. Esto habilitará el acceso remoto para jupyterlab.

c.ServerApp.allow_remote_access = True

Guarda y sal del archivo cuando termines.

Ahora ejecuta el siguiente comando para reiniciar el servicio jupyterlab y aplicar tus cambios. Después de habilitar el acceso remoto en Jupyter, se generará un nuevo token para configurar una contraseña.

sudo systemctl restart jupyterlab

Mira la parte inferior del mensaje y copia el token generado para Jupyter.

Configurando Nginx como un proxy inverso

En esta sección, instalarás y configurarás Nginx como un proxy inverso para tu instalación de Jupyter. Así que asegúrate de tener tu nombre de dominio, ya sea un dominio público o privado.

Instala el servidor web Nginx con el siguiente comando - Ingresa Y para proceder con la instalación.

sudo apt install nginx

Después de que la instalación esté completa, crea una nueva configuración de bloque de servidor Nginx /etc/nginx/sites-available/jupyterlab con el siguiente comando del editor nano.

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

Agrega la siguiente configuración al archivo y asegúrate de cambiar el nombre de dominio dentro de la opción 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;
    }
}

Cuando termines, guarda y sal del archivo.

Ahora ejecuta el siguiente comando para activar el bloque de servidor jupyterlab y verificar la sintaxis de tu Nginx. Si tienes la configuración correcta, obtendrás una salida syntax is ok ... test is successful.

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

Por último, ejecuta el siguiente comando para reiniciar Nginx y aplicar tu nueva configuración de bloque de servidor jupyterlab. Después de que se ejecute el comando, tu Jupyter estará funcionando bajo el proxy inverso de Nginx.

sudo systemctl restart nginx

Accediendo a Jupyter

Si estás usando Linux o MacOS, edita el archivo /etc/hosts. Para los usuarios de Windows, edita el archivo C:\System32\drivers\etc\hosts como administrador.

Agrega tu dirección IP del servidor y el nombre de dominio Jupyter como el siguiente:

192.168.5.65 lab.howtoforge.local

Guarda y sal del archivo.

Ahora abre tu navegador web y visita tu nombre de dominio Jupyter como http://lab.howtoforge.local/. Si tu configuración es exitosa, verás la página de inicio de sesión de Jupyter.

Desplázate hacia abajo y pega el token para tu instalación de Jupyter. Luego, ingresa la nueva contraseña para Jupyter y haz clic en Iniciar sesión y establecer nueva contraseña.

Si es exitoso, verás el panel de Jupyter como el siguiente - Y tu contraseña para Jupyter también habrá cambiado.

Conclusión

¡Felicidades! Has completado la instalación de Jupyter en Ubuntu 24.04. Ahora tienes Jupyter funcionando con Nginx como un proxy inverso y asegurado con autenticación por contraseña. Si estás ejecutando Jupyter en un servidor público o VPS (Servidor Privado Virtual), debes implementar HTTPS sobre tu proxy inverso de Nginx. Puedes lograr eso a través de Certbot y Letsencrypt.