In most cases, users already have a Notebook or a set of Notebook files they wish to use for their courses. Usually these files are located within a
git compatible repo, such has GitHub, GitLab, or BitBucket.
Create a New Workspace
Once you have created a new project, you can then create a new
workspace . A workspace is equivalent to a
server instance , in this case a Jupyter Notebook server instance.
For those of you that are familiar with launching Jupyter Notebooks from your terminal, this is equivalent to:
$ python3 -m pip install --upgrade pip
$ python3 -m pip install jupyter
$ jupyter notebook
workspace by clicking on the
Add a Workspace button within your project's main page:
Create a new workspace by setting name, size, and type
As illustrated above, a new workspace requires:
A workspace name
The workspace size
The workspace type
Once you have created your workspace, click on
Start . This will spawn a new workspace instance which will then allow you to open the workspace with
Launch . By default, the workspace opens in a new browser tab.
Add your Course Files
You should now have a valid user account, a project, and a workspace. Make sure your
Status set to
Running and and that the
Launch link appears under Actions:
A workspace instance with Status = Running
You can either upload files with the workspace's integrated file manager or you can clone a
git compatible repository:
Click on the
Launchlink to open your Jupyter Notebook in a new tab.
Click on the
Uploadicon to select and upload the files to your workspace.
Upload files from your local computer
Clone a Git Repository
From the dashboard, create a new Terminal or Notebook kernel by clicking on the corresponding icon.
Clone your repo either from the interactive Notebook interface or directly from the Terminal.
If using the
git cloneuse the "bang" command to emulate a terminal command like so:
Launch a new notebook to clone git repos or use the integrated upload option.
Congrats! You should now have a unique account, project, and workspace!
Now would be a good time to create a new OAuth2 application and credentials to connect IllumiDesk to the CanvasLMS.