JupyterLab adalah lingkungan pengembangan interaktif berbasis web open-source yang memperluas pengalaman Jupyter Notebook klasik. Ini menyediakan antarmuka yang lebih fleksibel dan kuat untuk tugas ilmu data dan komputasi ilmiah. JupyterLab mendukung berbagai bahasa pemrograman, dengan fokus kuat pada Python, dan menawarkan fitur seperti pengeditan kode, visualisasi data, dan output interaktif dalam ruang kerja terintegrasi tunggal. Pengguna dapat membuat dan mengelola notebook, editor teks, terminal, dan komponen kustom lainnya dalam tata letak bertab, meningkatkan produktivitas dan kolaborasi. Di Ubuntu, JupyterLab dapat dengan mudah diinstal melalui manajer paket seperti apt atau melalui penginstal paket Python pip, menjadikannya alat yang mudah diakses untuk developer dan peneliti yang menggunakan distribusi Linux populer ini.
Panduan Instalasi
Panduan ini akan menunjukkan cara menginstal JupyterLab di Ubuntu 24.04, mengamankannya dengan autentikasi kata sandi, dan mengonfigurasi Nginx sebagai reverse proxy untuk akses remote.
Prasyarat:
- Sistem operasi Ubuntu 24.04.
- Pengguna non-root dengan hak administrator.
- Nama domain yang diarahkan ke alamat IP server (domain publik atau privat).
Instalasi Dependensi
Pertama, kita perlu menginstal dependensi untuk Jupyter, termasuk Python, Pip, venv, dan Node.js. Paket-paket ini tersedia secara default di repositori Ubuntu, dan dapat diinstal melalui manajer paket APT.
- Perbarui indeks paket Ubuntu dengan perintah:
Bash
sudo apt update
- Instal Python3 dan Node.js dengan perintah berikut. Ketik Y untuk mengkonfirmasi instalasi:
Bash
sudo apt install python3-dev python3-pip python3-venv nodejs npm
- Setelah instalasi selesai, periksa versi Python, Node.js, dan Pip:
Bash
python3 -v
pip3 -v
node -v
Instalasi Jupyter
Setelah dependensi terinstal, kita akan menginstal Jupyter melalui Pip di lingkungan virtual Python. Pastikan Anda telah membuat lingkungan virtual sebagai pengguna non-root.
- Login ke user Anda (contoh: user
alice
):
Bash
su - alice
- Buat direktori baru
~/Dev
dan pindah ke direktori tersebut. Kemudian, buat lingkungan virtual Python venv:
Bash
mkdir -p ~/Dev; cd ~/Dev
python3 -v venv venv
- Aktifkan lingkungan virtual venv:
Bash
source venv/bin/activate
- Instal Jupyter melalui Pip:
Bash
pip3 install jupyter
- Periksa versi Jupyter:
Bash
jupyter --version
Konfigurasi Jupyter
Sekarang, kita akan mengkonfigurasi dua komponen utama Jupyter, yaitu jupyter_server dan jupyterlab. Ini meliputi pembuatan konfigurasi dan pengaturan autentikasi kata sandi untuk keduanya.
- Generate konfigurasi jupyter_server dan atur kata sandi:
Bash
jupyter server --generate-config
jupyter server password
- Periksa konfigurasi jupyter_server:
Bash
jupyter server --show-config
- Generate konfigurasi jupyterlab dan periksa konfigurasinya:
Bash
jupyter lab --generate-config
jupyter lab --show-config
- Jalankan JupyterLab:
Bash
jupyter lab --ip 0.0.0.0
- Akses JupyterLab di http://server-ip:8888/lab.
- Tekan Ctrl+c dan ketik
yes
untuk menghentikan proses JupyterLab.
Menjalankan JupyterLab sebagai Layanan
Jupyter akan dijalankan di latar belakang sebagai layanan.
- Buat file layanan systemd baru:
Bash
sudo nano /etc/systemd/system/jupyterlab.service
- Tambahkan konfigurasi berikut (ganti
alice
dengan username Anda):
[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
- Simpan dan keluar dari editor.
- Muat ulang system
Melanjutkan Instalasi JupyterLab di Ubuntu 24.04
Menjalankan JupyterLab sebagai Layanan (Lanjutan)
- Muat ulang systemd dan aktifkan service JupyterLab:
Bash
sudo systemctl daemon-reload
sudo systemctl start jupyterlab
sudo systemctl enable jupyterlab
- Periksa status service JupyterLab:
Bash
sudo systemctl status jupyterlab
Mengaktifkan Akses Remote Jupyter
Sebelum mengkonfigurasi Nginx, kita perlu mengaktifkan akses remote pada JupyterLab.
- Buka file konfigurasi JupyterLab:
Bash
nano ~/.jupyter/jupyter_lab_config.py
- Ubah opsi
c.ServerApp.allow_remote_access
menjadiTrue
:
Python
c.ServerApp.allow_remote_access = True
- Simpan dan keluar dari editor.
- Restart service JupyterLab:
Bash
sudo systemctl restart jupyterlab
Mencatat Token Jupyter
Setelah akses remote diaktifkan, token baru untuk mengatur kata sandi akan dihasilkan. Catat token ini.
Mengonfigurasi Nginx sebagai Reverse Proxy
Nginx akan digunakan sebagai reverse proxy untuk memungkinkan akses JupyterLab dari luar.
- Instal Nginx:
Bash
sudo apt install nginx
- Buat file konfigurasi server block Nginx:
Bash
sudo nano /etc/nginx/sites-available/jupyterlab
- Tambahkan konfigurasi berikut (ganti
lab.howtoforge.local
dengan nama domain Anda):
Nginx
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;
}
}
- Simpan dan keluar dari editor.
- Aktifkan server block JupyterLab dan periksa sintaks Nginx:
Bash
sudo ln -s /etc/nginx/sites-available/jupyterlab /etc/nginx/sites-enabled/
sudo nginx -t
- Restart Nginx:
Bash
sudo systemctl restart nginx
Mengakses JupyterLab
- Edit file
/etc/hosts
(Linux/MacOS) atauC:\System32\drivers\etc\hosts
(Windows) dengan hak administrator. - Tambahkan alamat IP server dan nama domain Jupyter:
192.168.5.65 lab.howtoforge.local
- Akses JupyterLab di http://lab.howtoforge.local/.
Catatan:
- Pastikan untuk mengganti
lab.howtoforge.local
dengan nama domain Anda yang sebenarnya. - Jika Anda menggunakan firewall, pastikan untuk membuka port 80 untuk mengakses JupyterLab dari luar.
Kesimpulan
Dengan mengikuti panduan ini, Anda telah berhasil menginstal JupyterLab di Ubuntu 24.04, mengamankannya dengan autentikasi kata sandi, dan mengkonfigurasi Nginx sebagai reverse proxy untuk akses remote. Sekarang, Anda dapat menggunakan JupyterLab untuk melakukan tugas ilmu data dan komputasi ilmiah dengan mudah dan aman.
Sumber Daya Tambahan:
- Dokumentasi JupyterLab: https://readthedocs.org/projects/jupyter-notebook/
- Dokumentasi Nginx: https://nginx.org/en/docs/