Quick Start Guide

Accessing Jetstream

Jetstream is accessible through a web interface https://use.jetstream-cloud.org using XSEDE credentials via Globus Auth.  Jetstream is not accessible via XSEDE's Single Sign-On Login Hub.  Newly created XSEDE accounts must be added to a specific allocation by the PI or Resource manager in order to access Jetstream.

Jetstream allocations are awarded exclusively through the eXtreme Science and Engineering Discovery Environment (XSEDE). XSEDE provides XSEDE User Portal (XUP) accounts free of charge. 

To get a Jetstream Trial Access account, please see Get a Jetstream Trial Access account. These accounts have limited resources available but allow you to try Jetstream

To get a more full-featured account, you'll request a startup allocation, please see Jetstream Allocations for step by step instructions.

For complete details and screen shots see, System Access - Logging into Jetstream Atmosphere.

Getting started

  1. To start the VM provisioning process, navigate to https://use.jetstream-cloud.org.
  2. Click Login in the top right to authenticate using your XSEDE credentials.
  3. On the Globus Auth screen click   .
  4. Enter your XSEDE credentials; confirm whether you will allow your credentials to be used to access Jetstream.
    Best results will occur if you treat your username as if it were case-sensitive when using Jetstream.
  5. Complete your multifactor authorization with your provider and separate device (like a smart phone).
  6. To proceed, you maybe requested to click Allow  for Jetstream web-apps and the web interface to Jetstream will load.
  7. Once you are authenticated via Globus Auth, you will end up on the Jetstream landing page, also called the Dashboard.  On this page you will be able to:
    • launch a new instance
    • browse help resources
    • change your settings
    • see your resources and usage history
    • view a Jetstream Community Activity feed
  8. As SSH is a primary method to access Jetstream resources, we recommend you add SSH keys for each host machine from which you will connect to Jestream.

Launch an instance

Launch an instance

To launch an instance, you will need to:

  1. open up the Jetstream Atmosphere page, https://use.jetstream-cloud.org
  2. follow the instructions below
  • PLEASE NOTE: It can take 5-10 minutes for an instance to fully deploy, so you may wish to plan accordingly.

  1. Click from the Dashboard screen.
  2. On the Featured Images screen, search for the image you would like to use or to scroll through the images that you have permission to use.
  3. Click on the image you would like to use then click to begin the process of creating an instance.
  4. On the 'Launch an Instance / Basic Options' page:
    1. Give your instance a name
    2. Select the version if there are multiple versions available
    3. Select a project for your instance or create a new project
    4. Select the allocation source
    5. Choose which provider you want to run on, Indiana or TACC
    6. Select the instance size
    7. Click .
  5. Review the information entered for provisioning your instance. 
    1. If everything is OK click to start the build process.
    2.  To make changes, click to return to previous screens. 
    3. To add or create a deployment script, click
  6.  When the status shows as , click on the name of the instance to display the instance details.
  7. To login to the instance, click on , located on the lower right hand side of the screen under Links. If this is unavailable try refreshing your window. If the link is still not enabled, log in to your instance via SSH for your operating system.
  8. If you are using  and you did not install your SSH key before provisioning and launching the instance you will be prompted to enter your XSEDE username and password.