Instance Setup

Jupyter

11min
jupyter is an interactive notebook interface that is very popular for ai/ml development using python using jupyter, you can connect to an interface in your browser and open any notebook that you can download as a ipynb file we recommend this launch mode to start we also recommend this launch mode over trying to run google colab with vast while google colab has a way to connect to a "local runtime", running jupyter directly is more robust and less error prone if connections drop or the browser window is closed by default jupyter instances use a proxy server this is a simple setup that works on machines with or without open ports the only downside is it can be slower to upload/download large files jupyter direct https launch mode when selecting jupyter there is a check box for "jupyter direct https" this preferred option will establish a direct connection to the instance which is faster for uploading and downloading files from your local machine selecting this option will automatically filter out machines that do not have open ports, as they cannot establish a direct connection jupyter uses a browser interface, so to get the direct https connection to work, you will need to install a certificate onto your operating system ⚠️ warning if you don't install the browser certificate, windows and linux will show a "your connection is not private" privacy error it is annoying but you can click through by clicking "advanced" and then proceed if you don't install the certificate on macos, the os might not let you open the jupyter webpage installing the tls certificate start by downloading the certificate here https //console vast ai/static/jvastai root cer then follow the directions for your operating system in most operating systems, double clicking on the certificate will start an installation wizard you can also access the correct settings by clicking on the appropriate security settings in your browser chrome on windows open your chrome security settings by clicking on the three dot menu in the upper right then click settings then click privacy and security on the left hand navigation from that menu, select security click on "manage device certificates" click next and then click import and find the downloaded jvastai root cer https //console vast ai/static/jvastai root cer file click "place all certificates in the following store" and then use the browse button click on the trusted root certification authorities folder cert chrome windows 1 click finish and agree to finalize the import no reboot is necessary and all new instances created will then not have the warning pop up note that existing instances will still have the warning chrome on linux open your chrome security settings by clicking on the three dot menu in the upper right then click settings then click privacy and security on the left hand navigation from that menu, select security (safe browsing) scroll down and select "manage certificates" on that page select the 'authorities' tab under 'manage certificates' press the import button and import the downloaded jvastai root cer https //console vast ai/static/jvastai root cer file you may need to select show all file types windows general after downloading the certificate https //console vast ai/static/jvastai root cer , double click on it to open the installation wizard click "open" cert windows 1 click on the "install certificate" button select either the current user or local machine and hit next cert windows 2 click "place all certificates in the following store" click browse and select the folder "trusted root certification authorities" click ok then click next click "finish" to install the certificate cert windows 3 reboot the machine so the change can take effect macos double click the certificate https //console vast ai/static/jvastai root cer after downloading it it will then be added to your keychain under the login default keychain make sure that the keychain access application is opened and that there is an entry for vast ai jupyter in the list of certificates if it does not appear, then use the import button to manually import the certificate so that it appears in your list of certificates cert macos 1 double click the entry and then click on the "trust" box change the "when using this certificate" box to "always trust" cert macos 2 close the window the change should take effect immediately for all instances you have running and create in the future