Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
54 changes: 27 additions & 27 deletions src/content/docs/getting-started.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ sso_role_name=DeveloperRole
region=us-east-1
```

More information on using IAM users and roles can be found [here](https://medium.com/the-coinbase-blog/you-need-more-than-one-aws-account-aws-bastions-and-assume-role-23946c6dfde3).
More information on using IAM users and roles can be found [here](https://blog.coinbase.com/you-need-more-than-one-aws-account-aws-bastions-and-assume-role-23946c6dfde3).

```
# ~/.aws/credentials
Expand All @@ -64,7 +64,7 @@ role_arn=arn:aws:iam::123456789012:role/my-role

## Installing the CLI

In order to use Granted you'll need to install it on your system. Common Fate provides binaries for Granted.
In order to use Granted you'll need to install it on your system.

<Tabs>
<TabItem label="MacOS">
Expand All @@ -81,22 +81,22 @@ In order to use Granted you'll need to install it on your system. Common Fate pr
#### For Intel (x86_64 architecture):

```bash
curl -OL https://releases.granted.dev/granted/v0.38.0/granted_0.38.0_darwin_x86_64.tar.gz
sudo tar -zxvf ./granted_0.38.0_darwin_x86_64.tar.gz -C /usr/local/bin/
curl -OL https://releases.granted.dev/granted/v0.39.0/granted_0.39.0_darwin_x86_64.tar.gz
sudo tar -zxvf ./granted_0.39.0_darwin_x86_64.tar.gz -C /usr/local/bin/
ln -s /usr/local/bin/granted /usr/local/bin/assumego
```

#### For ARM (arm64 architecture):

```bash
curl -OL https://releases.granted.dev/granted/v0.38.0/granted_0.38.0_darwin_arm64.tar.gz
sudo tar -zxvf ./granted_0.38.0_darwin_arm64.tar.gz -C /usr/local/bin/
curl -OL https://releases.granted.dev/granted/v0.39.0/granted_0.39.0_darwin_arm64.tar.gz
sudo tar -zxvf ./granted_0.39.0_darwin_arm64.tar.gz -C /usr/local/bin/
ln -s /usr/local/bin/granted /usr/local/bin/assumego
```

## Reverting to an older version of Granted

If you need to revert to an older version of Granted, you can manually downgrade using the following steps. First, make sure to uninstall your current version of granted. Replace "0.38.0" with the specific version you want to install.
If you need to revert to an older version of Granted, you can manually downgrade using the following steps. First, make sure to uninstall your current version of granted. Replace "0.39.0" with the specific version you want to install.

#### Using Homebrew
```
Expand All @@ -109,16 +109,16 @@ In order to use Granted you'll need to install it on your system. Common Fate pr
#### For Intel (x86_64 architecture):

```bash
curl -OL https://releases.granted.dev/granted/v0.38.0/granted_0.38.0_darwin_x86_64.tar.gz
sudo tar -zxvf ./granted_0.38.0_darwin_x86_64.tar.gz -C /usr/local/bin/
curl -OL https://releases.granted.dev/granted/v0.39.0/granted_0.39.0_darwin_x86_64.tar.gz
sudo tar -zxvf ./granted_0.39.0_darwin_x86_64.tar.gz -C /usr/local/bin/
ln -s /usr/local/bin/granted /usr/local/bin/assumego
```

#### For ARM (arm64 architecture):

```bash
curl -OL https://releases.granted.dev/granted/v0.38.0/granted_0.38.0_darwin_arm64.tar.gz
sudo tar -zxvf ./granted_0.38.0_darwin_arm64.tar.gz -C /usr/local/bin/
curl -OL https://releases.granted.dev/granted/v0.39.0/granted_0.39.0_darwin_arm64.tar.gz
sudo tar -zxvf ./granted_0.39.0_darwin_arm64.tar.gz -C /usr/local/bin/
ln -s /usr/local/bin/granted /usr/local/bin/assumego
```

Expand All @@ -133,15 +133,15 @@ In order to use Granted you'll need to install it on your system. Common Fate pr
# install GPG
sudo apt update && sudo apt install gpg

# download the Common Fate Linux GPG key
wget -O- https://apt.releases.commonfate.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/common-fate-linux.gpg
# download the Granted APT GPG key
curl -fsSL https://apt.releases.granted.dev/gpg | sudo gpg --dearmor -o /usr/share/keyrings/granted.gpg

# you can check the fingerprint of the key by running
# gpg --no-default-keyring --keyring /usr/share/keyrings/common-fate-linux.gpg --fingerprint
# the fingerprint of our Linux Releases key is 783A 4D1A 3057 4D2A BED0 49DD DE9D 631D 2D1D C944
# gpg --no-default-keyring --keyring /usr/share/keyrings/granted.gpg --fingerprint
# the fingerprint of our Linux Releases key is B608 F73B 86DF B0E0 C49E B973 CBCC 5289 67C2 0914

# add the Common Fate APT repository
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/common-fate-linux.gpg] https://apt.releases.commonfate.io stable main" | sudo tee /etc/apt/sources.list.d/common-fate.list
# add the Granted APT repository
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/granted.gpg] https://apt.releases.granted.dev stable main" | sudo tee /etc/apt/sources.list.d/granted.list

# update your repositories
sudo apt update
Expand All @@ -167,24 +167,24 @@ In order to use Granted you'll need to install it on your system. Common Fate pr
<TabItem label="x86_64">

```bash
curl -OL releases.granted.dev/granted/v0.38.0/granted_0.38.0_linux_x86_64.tar.gz
sudo tar -zxvf ./granted_0.38.0_linux_x86_64.tar.gz -C /usr/local/bin/
curl -OL releases.granted.dev/granted/v0.39.0/granted_0.39.0_linux_x86_64.tar.gz
sudo tar -zxvf ./granted_0.39.0_linux_x86_64.tar.gz -C /usr/local/bin/
```

</TabItem>
<TabItem label="arm64">

```bash
curl -OL releases.granted.dev/granted/v0.38.0/granted_0.38.0_linux_arm64.tar.gz
sudo tar -zxvf ./granted_0.38.0_linux_arm64.tar.gz -C /usr/local/bin/
curl -OL releases.granted.dev/granted/v0.39.0/granted_0.39.0_linux_arm64.tar.gz
sudo tar -zxvf ./granted_0.39.0_linux_arm64.tar.gz -C /usr/local/bin/
```

</TabItem>
<TabItem label="i386">

```bash
curl -OL releases.granted.dev/granted/v0.38.0/granted_0.38.0_linux_i386.tar.gz
sudo tar -zxvf ./granted_0.38.0_linux_i386.tar.gz -C /usr/local/bin/
curl -OL releases.granted.dev/granted/v0.39.0/granted_0.39.0_linux_i386.tar.gz
sudo tar -zxvf ./granted_0.39.0_linux_i386.tar.gz -C /usr/local/bin/
```

</TabItem>
Expand All @@ -194,11 +194,11 @@ In order to use Granted you'll need to install it on your system. Common Fate pr
<TabItem label="Windows">
First, download the zip archive of Granted which matches your system's architecture. You can find your architecture by viewing your system properties in the Control Panel.

[Granted for Windows x86_64](https://releases.granted.dev/granted/v0.38.0/granted_0.38.0_windows_x86_64.zip)
[Granted for Windows x86_64](https://releases.granted.dev/granted/v0.39.0/granted_0.39.0_windows_x86_64.zip)

[Granted for Windows arm64](https://releases.granted.dev/granted/v0.38.0/granted_0.38.0_windows_arm64.zip)
[Granted for Windows arm64](https://releases.granted.dev/granted/v0.39.0/granted_0.39.0_windows_arm64.zip)

[Granted for Windows i386](https://releases.granted.dev/granted/v0.38.0/granted_0.38.0_windows_i386.zip)
[Granted for Windows i386](https://releases.granted.dev/granted/v0.39.0/granted_0.39.0_windows_i386.zip)

After downloading Granted, unzip the package. Granted runs as two binaries, `assume` and `granted`. Any other files in the package can be removed, and Granted will still function.

Expand All @@ -220,7 +220,7 @@ To verify that the installation has succeeded, print the version of Granted by r
```
➜ granted -v

Granted v0.38.0
Granted v0.39.0
```

If you have any issues installing don't hesitate to [ask for help on our Slack](https://join.slack.com/t/commonfatecommunity/shared_invite/zt-q4m96ypu-_gYlRWD3k5rIsaSsqP7QMg).
Expand Down
Loading