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

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.
  • Throughout the cloud.gov documentation, select the GovCloud environment or East/West environment instructions based on where your spaces are located. If you’re not sure which to select, the GovCloud environment is the environment for new sandbox accounts and new teams. You can also ask a teammate or ask support.

Now try logging in:

In the GovCloud environment (what's this?)

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

Tip: The fr. in this URL (and other cloud.gov URLs) indicates the GovCloud environment.

In the East/West environment (what's this?)

https://dashboard.cloud.gov/

Note: If you just logged into the cloud.gov East/West environment for the first time, you won’t receive a sandbox space in the East/West environment. You can log into the cloud.gov GovCloud environment to get access to a sandbox space.

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 a command as explained below. Just like with the dashboard instructions, the GovCloud environment is the main environment for new accounts and teams.

In the GovCloud environment (what's this?)

For all accounts in the GovCloud environment:

Run 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.

In the East/West environment (what's this?)

If you’re at GSA or EPA and you log in with your agency account:

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

Then it’ll say One Time Code ( Get one athttps://login.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.

If you log in with a cloud.gov account that has its own password (including ORGNAME_deployer accounts): run cf login -a api.cloud.gov

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:

In the GovCloud environment (what's this?)

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

In the East/West environment (what's this?)

GSA and EPA: cf login -a api.cloud.gov --sso

Everyone else: cf login -a api.cloud.gov

Dashboard (web interface):

In the GovCloud environment (what's this?)

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

In the East/West environment (what's this?)

https://dashboard.cloud.gov/