Como Instalar JupyterLab no Ubuntu 24.04

JupyterLab é um ambiente de desenvolvimento interativo baseado na web e de código aberto que estende a experiência clássica do Jupyter Notebook, proporcionando uma interface mais flexível e poderosa para tarefas de ciência de dados e computação científica. Ele suporta várias linguagens de programação, com um forte foco em Python, e oferece recursos como edição de código, visualização de dados e saída interativa em um único espaço de trabalho integrado. O JupyterLab permite que os usuários criem e gerenciem notebooks, editores de texto, terminais e outros componentes personalizados em um layout com abas, aumentando a produtividade e a colaboração. No Ubuntu, ele pode ser facilmente instalado através de gerenciadores de pacotes como apt ou através do instalador de pacotes do Python, pip, tornando-se uma ferramenta acessível para desenvolvedores e pesquisadores que utilizam esta popular distribuição Linux.

Neste guia, você aprenderá como instalar Jupyter no Ubuntu 24.04. Você instalará e protegerá Jupyter com autenticação por senha. Em seguida, você instalará o Nginx e o configurará como um proxy reverso.

Pré-requisitos

Antes de começar, certifique-se de que você possui os seguintes requisitos:

• Um Ubuntu 24.04.
• Um usuário não-root com privilégios de administrador.
• Um nome de domínio apontado para um endereço IP de servidor (domínio público ou privado).

Instalando Dependências

Nesta seção, você instalará as dependências para Jupyter, que incluem Python, Pip, venv e Node.js. Esses pacotes estão disponíveis por padrão no repositório do Ubuntu, e você os instalará através do gerenciador de pacotes APT.

Para começar, execute o comando abaixo para atualizar o índice de pacotes do Ubuntu.

sudo apt update

Agora instale Python3 e Node.js através do repositório do Ubuntu com o seguinte - Digite Y para confirmar a instalação:

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

Após a conclusão da instalação, verifique a versão do Python, Node.js e Pip com o seguinte:

python3 -v
pip3 -v
node -v

Você pode ver abaixo que Python 3.12, Node.js 18 e Pip 24 estão instalados.

Instalando Jupyter

Após instalar as dependências, você instalará Jupyter através do Pip no ambiente virtual do Python. Você executará Jupyter como um usuário não-root, então certifique-se de que você o criou.

Faça login no seu usuário com o comando abaixo - O exemplo a seguir usará o usuário alice:

su - alice

Execute o comando abaixo para criar um novo diretório ~/Dev e mover-se para ele. Em seguida, crie um novo ambiente virtual Python venv.

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

Agora ative o ambiente virtual venv com o seguinte comando. Uma vez ativado, seu shell se tornará como (venv) user@hostname.

source venv/bin/activate

Em seguida, execute o comando pip3 abaixo para instalar Jupyter através do repositório PyPi:

pip3 install jupyter

Abaixo você pode ver a instalação do jupyter através do comando pip3:

Após o processo ser concluído, verifique a versão do Jupyter com o seguinte comando:

jupyter –version

Você verá a versão de cada componente do Jupyter, como jupyterlab, jupyter_server, jupyter_client, jupyter_core e iPython.

Configurando Jupyter

Nesta seção, você configurará dois componentes principais do Jupyter, que são jupyter_server e jupyterlab. Você gerará a configuração e configurará a autenticação por senha para ambos os componentes. Em seguida, você executará Jupyter através da linha de comando.

Primeiro, execute o comando jupyter abaixo para gerar a configuração do jupyter_server e a senha. Digite sua senha quando solicitado e repita.

jupyter server –generate-config
jupyter server password

Você pode ver abaixo que a configuração do jupyter_server foi gerada em ~/.jupyter/jupyter_server_config.py, e o arquivo de senha foi escrito em ~/.jupyter/jupyter_server_config.json.

Verifique a configuração do jupyter_server com o comando abaixo.

jupyter server –show-config

E você verá uma saída semelhante à seguinte:

Em seguida, execute o comando jupyter abaixo para gerar a configuração do jupyterlab em ~/.jupyter/jupyter_lab_config.py. Então, verifique a configuração do jupyterlab.

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

Na saída a seguir, o caminho da URL padrão para jupyterlab é /lab.

Agora execute o comando jupyter abaixo para iniciar o jupyterlab a partir da linha de comando. O jupyterlab deve estar rodando na porta 8888 e no caminho da URL lab.

jupyter lab –ip 0.0.0.0

Visite http://server-ip:8888/lab para acessar sua instalação do jupyterlab. Você verá o seguinte painel do Jupyter.

Agora pressione Ctrl+c e digite yes para encerrar o processo do jupyterlab.

Executando JupyterLab como um serviço

Neste guia, você executará Jupyter em segundo plano como um serviço. Então agora você precisa criar um novo arquivo de serviço systemd para Jupyter.

Crie um novo arquivo de serviço systemd /etc/systemd/system/jupyterlab.service com o seguinte comando do editor nano.

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

Insira a seguinte configuração e certifique-se de trocar o usuário alice pelo seu nome de usuário.

[Unit]
Description=JupyterLab Service

[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

Salve o arquivo e saia do editor quando terminar.

Agora execute o comando abaixo para recarregar o gerenciador systemd e ativar seu novo arquivo de serviço.

sudo systemctl daemon-reload

Em seguida, inicie e habilite o serviço jupyterlab com o comando abaixo.

sudo systemctl start jupyterlab
sudo systemctl enable jupyterlab

Por fim, execute o comando abaixo para verificar o status do serviço jupyterlab. Você verá que o serviço jupyterlab está em execução e habilitado em seu sistema.

sudo systemctl status jupyterlab

Permitindo acesso remoto ao Jupyter

Antes de configurar o Nginx como um proxy reverso, você precisa permitir o acesso remoto no jupyterlab. Agora você modificará o arquivo ~/.jupyter/jupyter_lab_config.py e habilitará o acesso remoto.

Primeiro, abra a configuração do jupyterlab ~/.jupyter/jupyter_lab_config.py com o seguinte editor nano.

nano ~/.jupyter/jupyter_lab_config.py

Descomente a opção c.ServerApp.allow_remote_access e mude para True. Isso habilitará o acesso remoto para jupyterlab.

c.ServerApp.allow_remote_access = True

Salve e saia do arquivo quando terminar.

Agora execute o comando abaixo para reiniciar o serviço jupyterlab e aplicar suas alterações. Após o acesso remoto ser habilitado no Jupyter, um novo token para configurar uma senha será gerado.

sudo systemctl restart jupyterlab

Dê uma olhada na parte inferior da mensagem e copie o token gerado para Jupyter.

Configurando o Nginx como um proxy reverso

Nesta seção, você instalará e configurará o Nginx como um proxy reverso para sua instalação do Jupyter. Então, certifique-se de que você possui seu nome de domínio, seja um domínio público ou privado.

Instale o servidor web Nginx com o comando abaixo - Digite Y para prosseguir com a instalação.

sudo apt install nginx

Após a conclusão da instalação, crie uma nova configuração de bloco de servidor Nginx /etc/nginx/sites-available/jupyterlab com o seguinte editor nano.

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

Adicione a seguinte configuração ao arquivo e certifique-se de trocar o nome do domínio dentro da opção 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 terminar, salve e saia do arquivo.

Agora execute o comando abaixo para ativar o bloco de servidor jupyterlab e verificar sua sintaxe do Nginx. Se você tiver a configuração correta, receberá uma saída syntax is ok ... test is successful.

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

Por fim, execute o comando abaixo para reiniciar o Nginx e aplicar sua nova configuração de bloco de servidor jupyterlab. Após a execução do comando, seu Jupyter estará rodando sob o proxy reverso do Nginx.

sudo systemctl restart nginx

Acessando Jupyter

Se você estiver usando Linux ou MacOS, edite o arquivo /etc/hosts. Para usuários do Windows, edite o arquivo C:\System32\drivers\etc\hosts como administrador.

Adicione seu endereço IP do servidor e o nome de domínio Jupyter como o seguinte:

192.168.5.65 lab.howtoforge.local

Salve e saia do arquivo.

Agora abra seu navegador da web e visite seu nome de domínio Jupyter como http://lab.howtoforge.local/. Se sua configuração for bem-sucedida, você verá a página de login do Jupyter.

Role para baixo até o final e cole o token para sua instalação do Jupyter. Em seguida, insira a nova senha para Jupyter e clique em Log in and set new password.

Se for bem-sucedido, você verá o painel do Jupyter como o seguinte - E sua senha para Jupyter também foi alterada.

Conclusão

Parabéns! Você completou a instalação do Jupyter no Ubuntu 24.04. Agora você tem o Jupyter rodando com o Nginx como um proxy reverso e protegido com autenticação por senha. Se você estiver executando o Jupyter em um servidor público ou VPS (Servidor Privado Virtual), você deve implementar HTTPS em cima do seu proxy reverso Nginx. Você pode conseguir isso através do Certbot e Letsencrypt.