conda-jupyter-env

A repo template for maintaining a conda env and running jupyter-notebook

Apply the template to start a new repo

• export this repo to ${another_directory}

  git checkout-index --all --prefix=${another_directory}/

• update this REAMDME.md

The env setup is for development only (not multi-user)

• env_create.sh to remove and create the env in one step

• jupyter_setup_kernel.sh to install a separate kernel for the env

  • enable jupyter notebook to use alternative kernels of different envs

• jupyter notebook.nohup runs like a system service

  • accept connections to jupyter over the network
  • use a self-signed ssl certificate for https
  • maybe useful to set a password
  • save log to file

Using the setup

conda env create/remove

• in the base env

• edit ./req.yml

  • change the name template for the new env
  • update the package list

• run ./env_create.sh to create the new env, it nest executes

  • extraction of the env name from ./req.yml

  • ./env_remove.sh to remove the current env, if exists

    • ./jupter_remove_kernel.sh to remove the env jupyter kernel, if installed

jupyter kernel notebook config

• in the new env

• run ./jupyter_setup_kernel.sh to install a jupyter kernel for the env, it nest executes

  • ./jupter_setup_ssl.sh to create a self-signed ssl cert file and key ./jupyter.pem for jupyter notebook

• edit ./jupyter_notebook_config.py if needed; the config sets

  • cert and key files to ./jupyter.pem
  • ip 0.0.0.0 to listens all network connections
  • notebook directory to ./ipynb
  • no starting a browser
  • (NOTE password is unset)

run jupyter notebook like a system service

• ./jupyter_notebook.nohup start

• ./jupyter_notebook.nohup stop

• ./jupyter_notebook.nohup status

• less ./jupyter_notebook.log to view the log

notebook directory ipynb

• 0pagesetup.ipynb - a common notebook page setup