Guía para instalar JupyterLab en Ubuntu 24.04

JupyterLab es un entorno de desarrollo interactivo y colaborativo diseñado principalmente para la computación interactiva, la visualización de datos y la ciencia de datos. Es una interfaz basada en web que permite a los usuarios crear y compartir documentos Jupyter, que pueden contener código, texto enriquecido, visualizaciones, ecuaciones y widgets interactivos.

Algunas características clave de JupyterLab incluyen:

1. Interfaz modular: Permite organizar y personalizar el entorno de trabajo con múltiples paneles y pestañas para editar archivos, ejecutar código, ver resultados y explorar datos.
2. Soporte multi-lenguaje: Es compatible con varios lenguajes de programación, incluidos Python, R, Julia y muchos otros, lo que permite desarrollar y ejecutar código en diferentes entornos.
3. Visualización interactiva: Ofrece capacidades avanzadas de visualización de datos mediante la integración con bibliotecas como Matplotlib, Plotly y Bokeh, lo que permite crear gráficos interactivos y dashboards.
4. Extensiones y complementos: Permite la instalación de extensiones y complementos para ampliar su funcionalidad, como soporte para Git, editores de Markdown, y herramientas de depuración.
5. Colaboración y versionamiento: Facilita la colaboración en proyectos mediante la integración con sistemas de control de versiones como Git, lo que permite realizar un seguimiento de los cambios en los documentos y colaborar con otros usuarios.

En resumen, JupyterLab es una poderosa herramienta para el desarrollo interactivo y la exploración de datos, que ofrece flexibilidad, personalización y colaboración en un entorno basado en web.

En esta guía, lo guiaremos paso a paso a través de la instalación de JupyterLab en Ubuntu24.04. Instalará JupyterLab en el entorno virtual Python, ejecutando JupyterLab como un servicio systemd, luego instalará y configurará Nginx como un proxy inverso para JupyterLab.

Requisitos previos

Antes de comenzar, confirme que tiene lo siguiente:

• Un servidor con Ubuntu 24.04.
• Un usuario no root con privilegios de administrador.

Instalación de dependencias

En esta sección, instalará las dependencias de paquetes para Jupyter, que incluyen Python3 , el administrador de paquetes Pip , el entorno virtual Python venv y Node.js.

Antes de comenzar, actualice y actualice el índice de su paquete Debian usando el siguiente comando.

sudo apt update

Ahora instale las dependencias ejecutando el siguiente comando apt install. Con esto, instalará Python3 , el administrador de paquetes Pip , la administración del entorno virtual venv y Node.js.

sudo apt install python3 python3-pip python3-venv nodejs

Pulsa Enter para confirmar y continuar con la instalación.

Una vez instaladas las dependencias, ejecute el siguiente comando para verificar la versión de cada dependencia, incluidos Python3, Pip y Node.js.

python3 --version
pip3 --version
node --version

El siguiente resultado muestra que Python 3.12 , Pip 24 y Node.js 18.19 están instalados.

Instalación de Jupyter

Después de instalar las dependencias, instalará los metapaquetes de Jupyter utilizando el entorno virtual Python en la máquina Ubuntu 24.04. Para lograrlo, debes completar lo siguiente:

• Creando un entorno virtual Python
• Instalación de Jupyter
• Configurando JupyterLab

Empecemos.

Creando un entorno virtual Python

En esta sección, creará un nuevo entorno virtual de Python que se utilizará para la instalación de Jupyter. Con este escenario, tendrá un entorno de desarrollo aislado que no afectará a todo su sistema. Además, puedes recrear esto a medida que pasa el tiempo.

Inicie sesión con su usuario no root usando el siguiente comando.

su - user

Ahora cree un nuevo directorio ~/project y acceda a él. Luego, cree un nuevo entorno virtual llamado venv usando el siguiente comando. Después de ejecutar el comando, se creará el nuevo directorio venv.

mkdir -p ~/project; cd ~/project
python3 -m venv venv

A continuación, ejecute el siguiente comando para activar el entorno virtual venv. Una vez activado, su indicador de shell será como » (venv) usuario@nombredehost: … «.

source venv/bin/activate

Instalación de Jupyter

Después de crear un entorno virtual Python. instalará el paquete Jupyter a través de Pip. El paquete Jupyter es un metapaquete de ecosistemas de Jupyter, que incluye IPython, JupyterLab, Jupyter Server, Jupyter Notebook, qtconsole y muchos más.

Ejecute el comando pip3 a continuación para instalar Jupyter en su sistema Ubuntu.

pip3 install jupyter

Durante la instalación, a continuación se muestra el resultado que se mostrará en su terminal:

Una vez finalizada la instalación, verifique la ubicación del archivo binario de Jupyter y la versión usando el siguiente comando.

which jupyter
jupyter --version

En el siguiente resultado, debería ver que el archivo binario de Jupyter se encuentra dentro del directorio venv. Además, debería ver la versión del paquete Jupyter que está instalado en su sistema.

Configurando JupyterLab

JupyterLab es la interfaz de usuario basada en web de próxima generación para el ecosistema Jupyter. Con JupyterLab, puede trabajar con documentos y actividades como Jupyter Notebook, editor de texto y terminal en una sola ventana. JupyterLab le ofrece una experiencia similar a IDE para gestionar y desarrollar proyectos de Jupyter.

En esta sección, configurará JupyterLab para su proyecto Jupyter. Pero antes de eso, primero debe configurar Jupyter Server para proteger su instalación.

Primero, ejecute el siguiente comando para generar el archivo de configuración de Jupyter Server y configurar la contraseña. Ingrese su contraseña y repita.

jupyter server --generate-config
jupyter server password

Después de ejecutar el comando, la configuración del servidor Jupyter se generará en el directorio ~/.jupyter/ .

Puede verificar el contenido de la configuración de Jupyter Server usando el siguiente comando.

jupyter server --show-config

Se mostrará el resultado similar a continuación:

A continuación, ejecute el siguiente comando para generar una nueva configuración para JupyterLab. La configuración de JupyterLab se generará en el directorio ~/.jupyter/ .

jupyter lab --generate-config

Una vez generada la configuración, verifique la configuración de JupyterLab mediante el siguiente comando.

jupyter lab --show-config

A continuación se muestra un ejemplo de configuración de JupyterLab:

Ahora puede ejecutar la instalación de JupyterLab usando el siguiente comando. Asegúrese de cambiar la dirección IP con la dirección IP de su servidor.

jupyter lab --ip 192.168.1.100

JupyterLab se ejecutará en la dirección IP de su servidor con el puerto predeterminado 8888 . Se puede acceder a JupyterLab a través de la ruta URL /lab .

Abra su navegador web y visite la dirección IP de su servidor seguida del puerto 8888 y la ruta /lab , como http://192.168.1.100:8888/lab . Ingrese su contraseña de Jupyter Server y haga clic en Iniciar sesión para continuar.

Si tiene la contraseña adecuada, debería ver el panel de usuario de JupyterLab como el siguiente:

Ahora puede presionar Ctrl+c dos veces para finalizar el proceso de JupyterLab.

Ejecutando JupyterLab como un servicio Systemd

En el siguiente paso, creará un nuevo archivo de servicio systemd que se utilizará para ejecutar JupyterLab. De esta manera, su instalación de JupyterLab se ejecutará en segundo plano como un servicio systemd y podrá administrar JupyterLab fácilmente a través de la utilidad systemctl.

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

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

Inserte la siguiente configuración y asegúrese de cambiar el nombre de usuario vesko .

[Unit]
Description=JupyterLab Service

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

[Install]
WantedBy=multi-user.target

Cuando termine, guarde y cierre el archivo.

Ahora ejecute el siguiente comando systemctl para recargar el administrador systemd y aplicar los cambios.

sudo systemctl daemon-reload

Luego, inicie y habilite el servicio jupyterlab usando el siguiente comando.

sudo systemctl start jupyterlab
sudo systemctl enable jupyterlab

Por último, verifique el servicio jupyterlab para asegurarse de que se esté ejecutando.

sudo systemctl status jupyterlab

El siguiente resultado confirma que el servicio jupyterlab se está ejecutando.

Configurar Nginx como proxy inverso para Jupyter

En esta guía, ejecutará JupyterLab con Nginx como proxy inverso. Para lograrlo, debes completar lo siguiente:

• Permitir el acceso remoto a JupyterLab
• Instalación y configuración de Nginx como proxy inverso

Permitir el acceso remoto a JupyterLab

De forma predeterminada, solo se puede acceder a la instalación de JupyterLab a través de una dirección IP local. Para permitir la conexión remota, debe modificar la configuración predeterminada de JupyterLab.

Abra la configuración de JupyterLab ~/.jupyter/jupyter_lab_config.py usando el siguiente comando del nano editor.

nano ~/.jupyter/jupyter_lab_config.py

Descomente la opción c.ServerApp.allow_remote_access y cambie el valor a True . Esto hará que JupyterLab sea accesible desde una conexión remota, lo que incluye ejecutar JupyterLab detrás de un proxy inverso.

c.ServerApp.allow_remote_access = True

Guarde el archivo y salga del editor cuando haya terminado.

Ahora ejecute el siguiente comando systemctl para reiniciar el servicio jupyterlab y aplicar los cambios.

sudo systemctl restart jupyterlab

Luego, verifique el servicio jupyterlab usando el siguiente comando.

sudo systemctl status jupyterlab

En el resultado inferior, debería ver el token generado para acceder a su instalación de JupyterLab y asegúrese de copiarlo para la siguiente sección.

Instalación y configuración de Nginx como proxy inverso

Después de permitir el acceso remoto a JupyterLab, luego instalará Nginx y lo configurará como un proxy inverso para su instalación de JupyterLab.

Instale Nginx ejecutando el comando apt install a continuación.

sudo apt install nginx -y

A continuación se muestra el resultado durante la instalación de Nginx.

Después de instalar Nginx, cree una nueva configuración de bloque de servidor /etc/nginx/sites-available/jupyterlab usando el siguiente nano editor.

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

Inserte la siguiente configuración y asegúrese de cambiar el nombre de dominio dentro de la opción server_name .

server {
    listen 80;
    server_name jupyterlab.veselin.es;

    access_log /var/log/nginx/veselin.es.access.log;
    error_log /var/log/nginx/veselin.es.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;
    }
}

Guarde y salga del archivo cuando haya terminado.

Ahora ejecute el siguiente comando para activar el archivo de bloqueo del servidor /etc/nginx/sites-available/jupyterlab y verifique la configuración de Nginx.

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

Si tiene la sintaxis Nginx adecuada, debería obtener el resultado » la sintaxis está bien, la prueba fue exitosa «.

Por último, ejecute el comando systemctl a continuación para reiniciar el servicio nginx y aplicar los cambios. Luego, verifíquelo para asegurarse de que el servicio se esté ejecutando.

sudo systemctl restart nginx
sudo systemctl status nginx

Si Nginx se está ejecutando, debería activar la salida (en ejecución) .

Acceda a la instalación de JupyterLab a través de la máquina local

Para acceder a JupyterLab a través del nombre de dominio, puede utilizar el archivo /etc/hosts para clientes Linux o el archivo C:\Windows\System32\drivers\etc\hosts para usuarios de Windows.

Abra el archivo /etc/hosts en su cliente Linux usando el editor nano.

sudo nano /etc/hosts

Inserte la siguiente configuración en el archivo y asegúrese de cambiar la dirección IP y el nombre de dominio con su información.

192.168.1.100 jupyterlab.veselin.es

Guarde y salga del archivo cuando haya terminado.

A continuación, abra su navegador web y visite el nombre de dominio de su instalación de JupyterLab, como http://jupyterlab.veselin.es . Si su instalación es exitosa, debería obtener la página de inicio de sesión de JupyterLab.

En la página inferior, ingrese la contraseña generada y la nueva para su instalación de JupyterLab. Luego haga clic en el botón Iniciar sesión y establezca una nueva contraseña .

Si todo va bien, debería ser redirigido al panel de JupyterLab como se muestra a continuación.

Con esto, la instalación de JupyterLab estará completa.

Conclusión

Al completar esta guía paso a paso, habrá completado la instalación de JupyterLab en el servidor Ubuntu 24.04. Instaló JupyterLab usando el entorno virtual Python, ejecutó JupyterLab en segundo plano como un servicio systemd y configuró Nginx como un proxy inverso para JupyterLab. Ahora puedes crear y administrar tu proyecto Jupyter.