satnogs-wut/docs/README-voila.md

Voila

Voila is a way to turn Jupyter notebooks into web applications.

Install

Start with basic Debian Buster install.

# set up partitions
# XXX deps...
sudo apt update
sudo apt install apache2 python3-certbot-apache python3-pip sshfs npm nodejs
certbot
systemctl restart apache2
adduser wut
sudo su - wut
pip3 install --user --upgrade pip
# make sure new `pip3` at `~/.local/bin/pip3` is in front in `$PATH`.
echo 'PATH=~/.local/bin:$PATH' >> ~/.bashrc

logout #log back in as user wut sudo su - wut

Install Python packages for Voila

pip3 install --user --upgrade -r requirements-voila.txt

Enable Jupyter extensions

jupyter nbextension enable --py widgetsnbextension #jupyter labextension install @jupyter-widgets/jupyterlab-manager #jupyter serverextension enable --py jupyterlab --user

* Set up hosts file, network, etc.

* Set up apache proxy

Cruft to start voila:

cd /srv/satnogs/satnogs-wut/notebooks/

voila
--ExecutePreprocessor.timeout=600
--no-browser
--port=8867
--autoreload=True
--Voila.ip=localhost
--VoilaConfiguration.enable_nbextensions=False
--theme=dark
wut-web.ipynb
1>>~/log/voila.log 2>>~/log/voila.err &

# wut?
Site:

* https://spacecruft.org/spacecruft/satnogs-wut/