// Module included in the following assemblies:
// * rosa_govcloud/rosa-install-govcloud-cluster.adoc

:_mod-docs-content-type: PROCEDURE
[id="rosa-govcloud-deploy-cluster_{context}"]
= Preparing to deploy a {product-title} cluster in AWS GovCloud

[role="_abstract"]
To deploy a {product-title} cluster in AWS GovCloud, you must be logged in to your Red{nbsp}Hat FedRAMP account.

.Prerequisites

* You have configured your AWS CLI to use GovCloud.
* You are logged into your government region.

.Procedure

. Navigate to https://console.openshiftusgov.com/openshift/token.
. Sign in with your Red{nbsp}Hat FedRAMP account credentials where you will see a screen with your token.
. Copy your token for the next step.
+
. In your terminal:
+
.. Run `rosa login` and paste your copied token to log in to the service.
+
[source,terminal]
----
$ rosa login --govcloud --token=<TOKEN>
----
+
[NOTE]
====
Depending on your AWS CLI configuration, you might need to add a government region to the end of the command string, such as `--region us-gov-west-1`.
====
+
.. Run `rosa whoami` to confirm all information is correct ensuring that you are using the AWS Gov region and the {cluster-manager-first} API is “https://api.openshiftusgov.com”..
+
[source,terminal]
----
$ rosa whoami
----
+
.Example output

[source,text]
----
AWS ARN:                                 arn:aws-us-gov:iam::00000000000:user/rosa-gov-user
AWS Account ID:                       00000000000
AWS Default Region:                 us-gov-east-1
OCM API:                                   https://api.openshiftusgov.com
OCM Account Email:                  rosa-gov-user@redhat.com
OCM Account ID:                       3ZXXXXXXXXXXXXXXXXXXXXXXXXX
OCM Account Name:                 Rosa Gov
OCM Account Username:          rosa-gov-user
OCM Organization External ID:  rosa-gov-user
OCM Organization ID:                3ZXXXXXXXXXXXXXXXXXXXXXXXXX
OCM Organization Name:          rosa-gov-user
----
+
. You must create a VPC where {product-title} will be deployed.
For instructions on setting up a VPC, see link:https://docs.aws.amazon.com/ROSA/latest/userguide/getting-started-private-link.html#getting-started-private-link-step-2[Amazon VPC architecture for the AWS PrivateLink use case].


