Frequently Asked Questions

Sep 1, 2017. | By: Alex Staravoitau

What is Juno?

Juno is an iOS client for Jupyter — it lets you connect to a remote Jupyter server from your iPhone or iPad and do everything you do with Jupyter on desktop, anywhere.

Can it run notebooks locally?

No, you need a notebook server that will do the actual computing. There are many options of running a notebook server: it can be your own laptop in your local network, AWS node, or even a dedicated powerful GPU-enabled machine configured as a public server or accessible via tunneling. Alternatively, you could use one of cloud computing services that are based on Jupyter, such as CoCalc or Azure Notebooks.

Can I use my home PC as a Jupyter server?

Yes, absolutely! Your PC will need to be switched on and accessible to your iOS device at all times though. There are a couple of ways of connecting to it: if your iPad or iPhone is on the same local network (say, Wi-Fi), you can just use your PC’s IP address. If you would like to connect over the internet, you would need to configure your PC as a public server (see Running a public notebook server in Jupyter documentation).

Can I use SSH tunneling (aka port forwarding) in Juno?

You can access your server in Juno if you have SSH tunnel established on your iOS device; however, you may need a 3rd party app to configure the port forwarding part. There are apps on the AppStore that will let you establish a tunnel with port forwarding (for example, this one), and Juno will then work by pointing it at localhost and mapped port.

We plan to include SSH tunneling capability in Juno in one of our future releases.

My notebooks won’t connect!

Usually this means that your server uses a self-signed SSL certificate for HTTPS which doesn’t work on iOS due to security restrictions — neither in Safari nor in Juno. Check out our step-by-step guide on how to configure certificates and enable SSL, so that you are able to connect to your server from your iOS device.

Can I use some preconfigured server instead?

Yes, absolutely. If you don’t want to go through the hassle of configuring your own server, you could use one of cloud computing services that are based on Jupyter, such as CoCalc or Azure Notebooks.

Can I use Juno with Google Colaboratory?

Sadly, not yet. We would love to support Google Colaboratory as a cloud computing service, however, we are currently pending some additional info from the Google team. Meanwhile, I’d say it wouldn’t hurt to ping them through customer support, so that they know there is interest in Juno integration. 😉

Can’t I already do all that in Safari?

Juno can do a lot on top of what Safari has to offer! For instance, it has responsive and less intrusive interface and benefits from full hardware keyboard support.

My hardware keyboard doesn’t have an Esc key

Juno has additional binding to Control key, which duplicates Esc key and lets you enter command mode, for instance.

I can’t use assisted input using latin characters in Juno

Unfortunately, there is a known issue with assisted input using latin characters (something similar to IME in Windows, where you use latin characters to input in Japanese, Korean or Chinese). Apparently, this issue is caused by one of the components Jupyter is using, and this issue has been reported, although not resolved yet — see discussion here. We are looking into a workaround for Juno, and hope to fix or at least improve international input in our future releases. Sorry for inconvenience meanwhile.

I can’t view or edit text files in Juno

Editing of text files is switched off for now, but we are looking into ways of either allowing it the way Jupyter normally does, or at least letting you open copies of those files in other apps. Sorry for inconvenience meanwhile.

Does Juno support JupyterLab?

Juno doesn’t support any JupyterLab specific features yet; however, all JupyterLab servers also include “classic” Jupyter Notebook as a fallback option, which Juno works perfectly with. JupyterLab servers should be detected automatically in Juno, redirecting to this “classic” interface — if your server keeps loading JupyterLab, try appending /tree to your JupyterLab server URL.

We use Jupyter products in our organization

If your workflow involves Jupyter notebooks and:

Please, send an inquiry to [email protected], and we will be happy to help.

I discovered a defect

Please, report all defects and send feature requests to [email protected].

I can’t get it to work!

Please, check out Jupyter documentation on running a notebook server, or send an e-mail to [email protected].

Make sure to run a recent version of Jupyter Notebook, preferably 4.1.0 or higher.