Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Radiasoft Public JupyterHub


Spawn Failed: There are no more servers available.

You may get this error if our cluster has too many active users:

Spawn failed

The latest attempt to start your server has failed. There are no more servers available. Please wait a few minutes before trying again. Would you like to retry starting it?

You can only retry by clicking on the home page link and then clicking on Start My Server. Refreshing your browser page will not allow you to retry.

You can also submit an Issue so that we know you are waiting for a free server.



You can create a file in ~/jupyter/bashrc, and it will be read each time a terminal window starts. This will allow you to customize your shell environment. It will also be read when your server starts so if you would like a change to show up in notebooks, you will need to restart your server.


The directory ~/jupyter/bin is automatically inserted in your $PATH so you can create programs/scripts and chmod +x <file> in order to make them executable. You may need to type hash -r after you type a new commands.

This repo provides customizations for end-user containers started on This repo's is executed first then the user's, allowing the user to customize the output of this customization.

The file will be executed at every container start as follows:

. ~/.bashrc
git clone
. ./
cd ..
rm -rf

Since the script is run in a subshell, it has access to all the functions in the RadiaSoft downloader. For now, do not assume much about this context, but eventually an API will be refined.

Right now, it executes in the master branch. We'll eventually install on the channel, but you can expect that your personal repo will always install off of master.

Customization tips

Avoid hardwiring paths. Use $HOME or ~ in scripts. Don't assume anything about $USER, because it may change.

You can assume ~/jupyter is where the notebooks are stored and where the terminal boots from. This directory persists across container restarts so you should be careful not to stomp existing files.

Importing the Warp code in an IPython Notebook

Simply trying 'import warp' or 'from warp import *' will generate errors. Instead, use the following:

import sys
del sys.argv[1:]
from warp import *

European XFEL: the WaveProperGator (WPG) notebooks for running SRW

  1. Point your browser to the RadiaSoft JupyterHub server

  2. Login with your GitHub credentials.

  3. Click the "Terminal" button in the "Launcher" tab.

  4. In the new terminal window, type the following command:

jupyter$ git clone ./WPG
  1. Browse to a notebook, by doing (for example) the following:

Double click "WPG"

Double click "samples"

Double click "Tutorials"

Double click "Tutorial_case_1.ipynb"

  1. In the "Select Kernel" popup window, you can keep the default choice of "Python 2" by clicking the "SELECT" button.


RadiaSoft public Jupyter Server announcements and global configuration




No releases published


No packages published

Contributors 4