Jupyter Notebook¶
Jupyter Notebook is a web-based interactive computational environment for creating Jupyter notebook documents. A Jupyter Notebook document is a JSON document, following a versioned schema, and containing an ordered list of input/output cells which can contain code, text (using Markdown), mathematics, plots and rich media, usually ending with the “.ipynb” extension.
License¶
Jupyter Notebook is released under the BSD 3-Clause “New” or “Revised” License. All relevant information can be found in the LICENSE file in the repository of the project.
Prerequisites¶
Make sure pip is up-to-date:
[isabell@stardust ~]$ pip3 install --user --upgrade pip
Collecting pip
Using cached https://files.pythonhosted.org/packages/43/84/23ed6a1796480a6f1a2d38f2802901d078266bda38388954d01d3f2e821d/pip-20.1.1-py2.py3-none-any.whl
Installing collected packages: pip
Successfully installed pip-20.1.1
[isabell@stardust ~]$
Note
If you are using pip with the default configured Python 2.7.5 you may get a syntax error while installing jupyter. This guide uses pip3 so you do not need to change it.
Installation¶
[isabell@stardust ~]$ pip3 install --user jupyter
Downloading ...<- All the download operations will be displayed.
Installing collected packages: tornado, six, python-dateutil, ipython-genutils, decorator, traitlets, jupyter-core, pyzmq, jupyter-client, backcall, ptyprocess, pexpect, parso, jedi, wcwidth, prompt-toolkit, pickleshare, pygments, ipython, ipykernel, qtpy, qtconsole, MarkupSafe, jinja2, zipp, importlib-metadata, attrs, pyrsistent, jsonschema, nbformat, Send2Trash, terminado, webencodings, pyparsing, packaging, bleach, mistune, entrypoints, testpath, defusedxml, pandocfilters, nbconvert, prometheus-client, notebook, widgetsnbextension, ipywidgets, jupyter-console, jupyter
Running setup.py install for tornado ... done
Running setup.py install for pyrsistent ... done
Running setup.py install for pandocfilters ... done
Successfully installed MarkupSafe-1.1.1 Send2Trash-1.5.0 attrs-19.3.0 backcall-0.2.0 bleach-3.1.5 decorator-4.4.2 defusedxml-0.6.0 entrypoints-0.3 importlib-metadata-1.7.0 ipykernel-5.3.1 ipython-7.16.1 ipython-genutils-0.2.0 ipywidgets-7.5.1 jedi-0.17.1 jinja2-2.11.2 jsonschema-3.2.0 jupyter-1.0.0 jupyter-client-6.1.5 jupyter-console-6.1.0 jupyter-core-4.6.3 mistune-0.8.4 nbconvert-5.6.1 nbformat-5.0.7 notebook-6.0.3 packaging-20.4 pandocfilters-1.4.2 parso-0.7.0 pexpect-4.8.0 pickleshare-0.7.5 prometheus-client-0.8.0 prompt-toolkit-3.0.5 ptyprocess-0.6.0 pygments-2.6.1 pyparsing-2.4.7 pyrsistent-0.16.0 python-dateutil-2.8.1 pyzmq-19.0.1 qtconsole-4.7.5 qtpy-1.9.0 six-1.15.0 terminado-0.8.3 testpath-0.4.4 tornado-6.0.4 traitlets-4.3.3 wcwidth-0.2.5 webencodings-0.5.1 widgetsnbextension-3.5.1 zipp-3.1.0
[isabell@stardust ~]$
Note
With the following command you can start the jupyter server to test the basic installation without having a config file.
jupyter notebook --no-browser --ip 0.0.0.0 --port 8888
Without having set a password the server would generate a token instead which you use as a parameter in the url.
The token would then be displayed in the console output. You can also see if the selected port (in this case 8888) is available. Use another port for your configuration if this is the case. Terminate it with pressing Ctrl + c two times.
Configuration¶
Let’s generate a config file.
[isabell@stardust ~]$ jupyter notebook --generate-config
Writing default config to: /home/isabell/.jupyter/jupyter_notebook_config.py
[isabell@stardust ~]$
Modify the ~/.jupyter/jupyter_notebook_config.py and add the following parameters.
c.NotebookApp.allow_password_change = False
c.NotebookApp.ip = '0.0.0.0'
c.NotebookApp.open_browser = False
c.ContentsManager.root_dir = '/home/isabell/'
Note
The parameter c.ContentsManager.root_dir sets the root of the Jupyter file manger. So you could browse your whole user directory with this setting.
You may want to create a subfolder and then set the root_dir to /home/isabell/subfolder/
Set a password for a secure web access.
[isabell@stardust ~]$ jupyter notebook password
Enter password:
Verify password:
[NotebookPasswordApp] Wrote hashed password to /home/isabell/.jupyter/jupyter_notebook_config.json
[isabell@stardust ~]$
Setup daemon¶
Create ~/etc/services.d/jupyter.ini with the following content:
[program:jupyter]
command=jupyter notebook
autostart=true
autorestart=true
After creating the configuration, tell supervisord to refresh its configuration and start the service:
[isabell@stardust ~]$ supervisorctl reread
SERVICE: available
[isabell@stardust ~]$ supervisorctl update
SERVICE: added process group
[isabell@stardust ~]$ supervisorctl status
SERVICE RUNNING pid 26020, uptime 0:03:14
[isabell@stardust ~]$
Setup web backend¶
If you have your own domain you can set a domain specific web backend configuration. This guide overrides the default setting, so the default html folder is not accessible. Other options are described in the web-backend manual.
Note
Jupyter is running on port 8888 by default.
To make the application accessible from the outside, configure a web backend:
[isabell@stardust ~]$ uberspace web backend set / --http --port <port>
Set backend for / to port <port>; please make sure something is listening!
You can always check the status of your backend using "uberspace web backend list".
[isabell@stardust ~]$
Let’s check if it is working.
[isabell@stardust ~]$ uberspace web backend list
/ http:8888 => OK, listening: PID 29269, /usr/bin/python3 /home/isabell/.local/bin/jupyter-notebook
[isabell@stardust ~]$
Now you can access the Jupyter webinterface via https://isabell.uber.space
Updates¶
[isabell@stardust ~]$ pip3 install --user --upgrade jupyter
[isabell@stardust ~]$
Note
Check the update feed of the releases on GitHub regularly to stay informed about the newest version.
Tested with Jupyter 6.0.3, Uberspace 7.7.1.2
Written by: EV21 <uberlab@ev21.de>