US flag signifying that this is a United States Federal Government website An official website of the United States government

Set up cloud.gov and log in

Set up cloud.gov and log in

If you have set up your access to cloud.gov, you can log into cloud.gov in the following ways – dashboard (web interface) and command line.

Log into the dashboard (web interface)

cloud.gov has a dashboard that gives you easy web-based access to common tasks.

Your dashboard is probably empty right now since you probably haven’t deployed any applications yet, but it’s good to try logging in and looking at it as your first step, since you’ll use it in the future.

Two notes before you log in:

  • When you log in for the first time, cloud.gov will create a sandbox space for you, but it may take up to 5 minutes for cloud.gov to complete its automatic creation of your sandbox space. If you get stuck, ask a teammate or support.

Now try logging in: https://dashboard.fr.cloud.gov/

Tip: The fr. in this URL (and other cloud.gov URLs) is short for FedRAMP.

Set up the command line

cloud.gov is based on the Cloud Foundry open source project, so cloud.gov uses the Cloud Foundry command line interface (CLI) to give you full access to cloud.gov.

  1. Install the Cloud Foundry CLI using the installer for your system: Windows, Mac OS X, or Linux.
  2. Confirm the installation by running cf -v – this should return a version number.

  3. Log in with this command: cf login -a api.fr.cloud.gov --sso

    • Then it’ll say One Time Code ( Get one athttps://login.fr.cloud.gov/passcode) – visit that link in your browser to get your code, copy and paste the code into the command line (no typing indicators will show), and enter it.

Play around in your “sandbox”

Here’s how to deploy a test app in your sandbox for practice, using the CLI.

Start with the following cf target command:

cf target -o <ORG> -s <SPACE>

Your <ORG> is a Cloud Foundry organization named “sandbox-<agencypart>”, where <agencypart> is whatever comes right before .gov or .mil in your e-mail address. For example, this may be sandbox-gsa or sandbox-epa. In most cases, your <SPACE> is the part of your email before the @, e.g. firstname.lastname. Cloud Foundry spaces let applications run independently within an organization.

For example:

cf target -o sandbox-gsa -s harry.truman

Run your version of that command, and then follow your first deploy.

Quick reference

Here’s a summary of how to log into cloud.gov. (See above for details.)

Command line interface:

cf login -a api.fr.cloud.gov --sso

Dashboard (web interface):

https://dashboard.fr.cloud.gov/