AWS CloudShell is a browser-based shell available directly in the AWS Console. The scripts in this project are designed to run inside CloudShell sessions. Understanding the environment helps you know when versions change and when to re-run the scripts.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/rosswickman/aws-cloudshell-tools/llms.txt
Use this file to discover all available pages before exploring further.
Key Environment Characteristics
Session lifecycle
Session lifecycle
CloudShell sessions run on Amazon Linux 2. Each session can be up to 20 minutes of inactivity before it is paused. Sessions share a persistent home directory (~1 GB) across restarts within the same region, so files you download or install during one session remain available in the next.
Architecture
Architecture
CloudShell environments run on
x86_64 Linux, which is why update.sh downloads the awscli-exe-linux-x86_64.zip package from the official AWS installer endpoint.Pre-installed tools
Pre-installed tools
AWS pre-installs a curated set of tools including the AWS CLI, language runtimes (Python, Node.js, etc.), and the shells documented here. The exact versions depend on the CloudShell image version active at the time your session starts.
Region context
Region context
Each CloudShell session inherits the AWS region selected in the Console. AWS CLI commands run in that region by default, so switching regions in the Console and starting a new session changes the effective region for all CLI calls.
When Tool Versions Change
- AWS periodically releases new CloudShell environment images with updated tool versions
- Opening a new session may use a newer image than a previous session
- Running
update.shexplicitly upgrades AWS CLI v2 to the latest release independent of the image version - Other tools (
eb,ecs-cli,sam) follow the CloudShell image release cycle
Official AWS Reference
AWS maintains an official spec page listing all pre-installed software and their versions in CloudShell environments: AWS CloudShell VM Specifications.
Related Pages
Tools Covered
See the full list of shell runtimes and AWS CLI tools tracked by the scripts.
Update Tools
Learn how to run
update.sh to upgrade AWS CLI v2 inside your CloudShell session.