Installation
Install RepliMap CLI on your machine
Prerequisites
- Python: 3.10 or higher
- AWS CLI: Configured with credentials (
aws configure) - Terraform: (Optional) For applying generated code
Install RepliMap
We recommend pipx to install RepliMap in an isolated environment:
# Install pipx if needed
brew install pipx && pipx ensurepath # macOS
# or: pip install --user pipx && pipx ensurepath # Linux
# Install RepliMap
pipx install replimap
# Verify installation
replimap --version
# Update later
pipx upgrade replimappip install replimapuv pip install replimapNo Python installation required:
# Pull the image
docker pull replimap/replimap:latest
# Run with your local AWS credentials
docker run -v ~/.aws:/root/.aws replimap/replimap \
scan --profile prod --region us-east-1Configure AWS Credentials
RepliMap uses your standard AWS CLI credentials.
# Configure a new profile
aws configure --profile replimap
# Or use environment variables
export AWS_ACCESS_KEY_ID=your_access_key
export AWS_SECRET_ACCESS_KEY=your_secret_key
export AWS_DEFAULT_REGION=us-east-1Ensure your IAM user/role has read-only permissions. See IAM Policy for the minimum required permissions.
Verify Installation
# Check version
replimap --version
# Test AWS connectivity
aws sts get-caller-identity --profile replimap
# Run a test scan
replimap scan --profile replimap --region us-east-1Next Steps
Once installed, follow the Quick Start guide to run your first scan.