---
title: "Setup"
date: 2021-09-07T13:42:50-04:00
draft: false
weight: 30
---

## Account activation

To start using Amazon Genomics CLI with your AWS account, you need to activate it.

```
agc account activate
```

This will create the core infrastructure that Amazon Genomics CLI needs to operate, which includes a DynamoDB table, an S3 bucket and a VPC. This will take ~5min to complete. You only need to do this once per account region.

The DynamoDB table is used by the CLI for persistent state. The S3 bucket is used for durable workflow data and Amazon Genomics CLI metadata and the VPC is used to isolate compute resources. You can specify your own preexisting S3 Bucket or VPC if needed using `--bucket` and `--vpc` options.

### CDK Bootstrap

{{% alert title="Attention" color="warning" %}}
This step is NOT required when using Amazon Genomics CLI version 1.2 or above
{{% /alert %}}

Amazon Genomics CLI uses AWS CDK to deploy infrastructure. Activating an account will bootstrap the AWS Environment for CDK app deployments.
CDK Bootstrap deploys the infrastructure needed to allow CDK to deploy CDK defined infrastructure. Full details are available
[here](https://docs.aws.amazon.com/cdk/latest/guide/bootstrapping.html).


## Define a username

Amazon Genomics CLI requires that you define a username and email. You can do this using the following command:

`agc configure email you@youremail.com`

The username only needs to be configured once per computer that you use Amazon Genomics CLI from.