If your project contains a Jupyter notebook, there are two ways to run it. The first is to use the jupyter nbconvert command in a shell script. The second is to run Jupyter interactively by launching a fully-featured Jupyter environment in a separate tab.

To install Jupyter on Code Ocean:

From a python capsule, click the Environment and Dependencies icon and add jupyter   through either the pip or conda installers.  

To use Jupyter on Code Ocean:

First, If you are not viewing new Code Ocean, click the 'Preview the new CO' icon;

Second,from the interactive sessions dropdown, select Jupyter: 

This will trigger a new run accompanied by the words 'Interactive Session.
Third, when the words turn blue, click them (it is a link):

To launch Jupyter!

Interactive Jupyter notebooks are run in a separate container from their associated compute capsule in your browser. As such, you will be leaving the Code Ocean environment and your regular browser/Jupyter settings will apply.

Five general caveats about interactive sessions on Code Ocean:

  1. Leaving an interactive session running will continuously use quota until you stop the run by clicking the red square in the screenshot above. 
  2. Every 30 minutes, your interactive session will ask you if you are still there. This is to prevent an idly open tab from exhausting your quota. 
  3. When you open an interactive session, you may be prompted to accept notifications from Code Ocean. If you accept, you will receive this half-hourly reminder in your open interactive tab. If you do not accept, it will pop up in the Code Ocean capsule from which you launched the interactive session.
  4. If you do not actively tell Code Ocean that you are still working, every 30 minutes, your session will end and your work will be lost. Please pay attention to these notifications. 
  5. Work done in an interactive session will not be saved to your /code and /data panes. For the time being, please copy and re-implement any changes you wish to save back to your code and data.  


Did this answer your question?