Everware is about re-useable science, it allows people to jump right
in to your research code.
It lets you launch Jupyter notebooks from a git
repository with a click of a button. Everware is an extension for
JupyterHub. The main component is a spawner that allows you to spawn
custom docker images.
Checkout the ROADMAP to see where we are going
and how to get involved with the project.
See this blog
for more information about what
everware is and how it can be useful.
We have some documentation on the different ways to use
Try it out
In order to deploy your own
everware instance, you have to:
- create and activate a
condaenvironment with python 3.5(or 3.6.0)
conda create -n everware python=3.5 source activate everware
- Clone this repo and install
git clone https://github.com/everware/everware cd everware make install
- Create a Github OAuth application
http://localhost:8000/and callback URL
Enter you OAuth information into
source env.sh. You will
have to set these environment variables every time before running
If you are on Mac OS make sure the VM in which docker runs is
docker-machine start <vm-name>) and your environment is
setup properly (
docker-machine env <vm-name>). Start
everware-server -f etc/local_dockermachine_config.py --debug --no-ssl
- If you are on Linux make sure
dockerdis running, your user
is in docker group and your environment contains the required
DOCKER_HOSTis set, etc). Then start
everware-server -f etc/local_config.py --debug --no-ssl
Everware can also be deployed in a Docker container. See Everware in Docker container
brew install selenium-server-standalone
Note: if you are not starting from an environment that already contains
dockerspawner make sure it is updated to the right commit.
be satisfied if it is installed which might leave you with an old version.
Paper (2017-02): https://arxiv.org/abs/1703.01200