Installation
Prerequisites
System Requirements
| Requirement | Details |
|---|---|
| Operating System | macOS or Linux |
| Java | JDK 21 or later |
| Docker | Required for building custom AMIs |
AWS Requirements
- AWS Account: A dedicated AWS account is recommended for lab environments
- AWS Credentials: Either static access key & secret, or a named profile — including an AWS SSO (IAM Identity Center) profile
- IAM Permissions: Permissions to create EC2, IAM, S3, and optionally EMR resources
Run easy-db-lab show-iam-policies to see the exact IAM policies required with your account ID populated. See Setup for details.
Optional
- AxonOps Account: For free Cassandra monitoring. Create an account at axonops.com
Install from Release
Download a tarball from the releases page and add the bin directory to your $PATH:
export PATH="$PATH:/path/to/easy-db-lab/bin"
Build from Source
git clone https://github.com/rustyrazorblade/easy-db-lab.git
cd easy-db-lab
./gradlew assemble
The built distribution will be in build/distributions/.
Next Steps
Run the interactive setup to configure your profile:
easy-db-lab setup-profile
See the Setup Guide for detailed instructions.