How Do I Install Stata on JupyterHub?

Step 1: Log onto the Yens

Step 2: Install Miniconda

We are going to use a personal installation of miniconda because Anaconda3 module conda version has a known bug.

chmod +x
conda config --set auto_activate_base false 

Now that miniconda is installed, add path to miniconda to your bash profile:

echo 'export PATH=$HOME/miniconda3/bin:$PATH' >> ~/.bash_profile
source ~/.bash_profile

Step 3: Load Stata and Anaconda modules

# loading stata module adds correct path to stata bin
ml statamp/17

Step 4: Make a new conda environment

# create a new conda env for the stata kernel and install necessary packages
conda create -n stata_kernel 

# activate env
source activate stata_kernel

# install stata kernel and jupyter
conda install -c conda-forge -c defaults stata_kernel jupyter 

# install Stata kernel to Jupyter
python -m stata_kernel.install

Before you test JupyterHub, it’s important to make sure the Stata kernel is using the correct Stata executable.

cat ~/.stata_kernel.conf


# Path to stata executable. If you type this in your terminal, it should
# start the Stata console
stata_path = /software/non-free/stata17/stata-mp

If you don’t see stata_path= /software/non-free/stata17/stata-mp, or it goes to a different path, edit the .stata_kernel.conf file so that it points to the path listed above.

Step 5: Start JupyterHub

You should now see Stata kernel under Notebooks:

Let’s test that Stata works. Open a new Stata notebook and run:

If you need to uninstall a particular Jupyter kernel, run:

# to list kernels
jupyter kernelspec list 

# to uninstall kernel called mykernel
jupyter kernelspec uninstall mykernel