mybinder.org-user-guide

mybinder.org-user-guide copied to clipboard

Opening any of the two binder links of the minimal Dockerfile example yields a notebook that simply displays a 404 error page: master branch truly-minimal branch Running jupyter-repo2docker https://github.com/binder-examples/minimal-dockerfile locally yields a working notebook.

Thank you for opening your first issue in this project! Engagement like this is essential for open source projects! :hugs:
If you haven't done so already, check out Jupyter's Code of Conduct. Also, please try to follow the issue template as it helps other other community members to contribute more effectively. You can meet the other Jovyans by joining our Discourse forum. There is also an intro thread there where you can stop by and say Hi! :wave:
Welcome to the Jupyter community! :tada:

That'll be due to the default URL changing to jupyterlab https://github.com/jupyterhub/binderhub/pull/1354

Options are to either change the binder badge to pass /tree as the starting URL, or to install JupyterLab in the minimal Dockerfile.

I also get the same problem when pasting the link to the GitHub repo on the mybinder.org starting page, so it's probably all links that are generated there: https://mybinder.org/v2/gh/binder-examples/minimal-dockerfile/HEAD

mybinder.org will try to send you to the URL at which JupyterLab is, but because the minimal example doesn't install JupyterLab you get a 404. This means that the minimal example needs updating so that it installs Jupyter Lab. Do you want to tackle that in a PR to https://github.com/binder-examples/minimal-dockerfile?

So that basically means that Docker Containers without JupyterLab are no longer really supported on mybinder.org? I guess then there are also some parts of the documentation that should be updated to reflect this, especially here and here. One could either remove the part about only installing notebook or make the information about how to switch between both versions more promininent with a warning on both pages saying that you'll need to manually fix your URLs.

So that basically means that Docker Containers without JupyterLab are no longer really supported on mybinder.org?

Not quite. You can make a container that doesn't have lab installed but then you will have to specify the URL that users should be redirected to because the default URL is the one JupyterLab uses.

Yes, there are unfortunately a lot of places in the docs that need updating that haven't yet been updated.

I opened PRs in #243, binder-examples/minimal-dockerfile#4 and binder-examples/minimal-dockerfile#5, feel free to edit them as you deem suitable. I also didn't update the example overview page, as that probably needs the other PRs merged and I currently have no environment at hand to actually run the script.