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

Set up and log in

Set up and log in

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

Log into the dashboard (web interface) 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, will create a sandbox space for you, but it may take up to 5 minutes for to complete its automatic creation of your sandbox space. If you get stuck, ask a teammate or support.

Now try logging in:

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

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

  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 --sso

    • Then it’ll say One Time Code ( Get one at – 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 (See above for details.)

Command line interface:

cf login -a --sso

Dashboard (web interface):