yuvipanda / jupyterhub-ssh

SSH Access to JupyterHubs
BSD 3-Clause "New" or "Revised" License
93 stars 29 forks source link

Add initial docs #18

Closed GeorgianaElena closed 3 years ago

consideRatio commented 3 years ago

As a novice about SSH tech etc, I'm not confident on where the JupyterHub SSH should be started. Is this understanding correct?

You configure JupyterHub SSH, a server listening on SSH communication, to speak with a specific JupyterHub instance. Then users accessing JupyterHub SSH will pass a token they have got from jupyterhub's UI in advance. And, by doing so, JupyterHub SSH will act on behalf of the user to spawn a user server and connect with it.

This means, that JupyterHub SSH can be started in a dedicated server, as long as it has network access to JupyterHub's public network entrypoint, which it likely will have anywhere. Is this correct?

consideRatio commented 3 years ago

@GeorgianaElena some indentation of content under numbered bullet points would look nice!

GeorgianaElena commented 3 years ago

This means, that JupyterHub SSH can be started in a dedicated server, as long as it has network access to JupyterHub's public network entrypoint, which it likely will have anywhere. Is this correct?

Yes, that's my understanding of it too.

yuvipanda commented 3 years ago

I also wrote some usage docs in https://docs.datahub.berkeley.edu/en/latest/users/ssh.html if that's helpful to steal!

yuvipanda commented 3 years ago

This is a great start, thank you @GeorgianaElena!!!!