# Graphistry on AWS: Environment Setup Instructions

Graphistry runs on AWS EC2. This document describes initial AWS virtual machine environment setup. From here, proceed to the general Graphistry installation instructions linked below. 

The document assumes light familiarity with how to provision a standard CPU virtual machine in AWS. 

For AWS Marketplace users and additional AWS configuration tips, instead see [AWS Marketplace Administration](https://github.com/graphistry/graphistry-cli/blob/master/docs/aws_marketplace.md)


Contents:

  1. Pick Linux distribution: Ubuntu 24.04/22.04 LTS (Others supported, see `etc/scripts/bootstrap`)
  2. Configure instance
  3. General installation

Subsequent reading: [General installation](https://github.com/graphistry/graphistry-cli)



# 1. Pick Linux distribution
Start with one of the following Linux distributions, and configure it using the instructions below under 'Configure instance'.

## Ubuntu 24.04/22.04 LTS (Recommended)
  * Available on official AWS launch homepage
  * Follow provisioning instructions from AWS install
  * Hardware type: See [cloud hw/sw recommendations](../../planning/hardware-software.md#cloud)
  * Login: ssh -i ...private_key.pem ubuntu@public.dns

## RHEL 8.x/9.x
  * See `etc/scripts/bootstrap` in your Graphistry distribution for setup scripts


# 2. Configure instance

* Instance: See [cloud hw/sw recommendations](../../planning/hardware-software.md#cloud)
* Security groups: ssh, http, https

# 3. General installation

Proceed to the instructions for [general installation](https://github.com/graphistry/graphistry-cli) and check [AWS Marketplace](aws_marketplace.md) for common AWS-specific configurations