e1s

AWS ECS terminal dashboard (like k9s for ECS)

TLDR

Launch the ECS dashboard
$ e1s
Connect to specific AWS profile
$ e1s --profile [profile_name]
View specific cluster on startup
$ e1s --cluster [cluster_name]
Connect to specific region
$ e1s --region [us-west-2]

SYNOPSIS

e1s [options]

DESCRIPTION

e1s is a terminal user interface for Amazon ECS (Elastic Container Service), inspired by k9s for Kubernetes. It provides a real-time dashboard for monitoring ECS clusters, services, tasks, and containers.The tool allows users to view resource status, view logs, execute commands in containers, and manage deployments without leaving the terminal. It integrates with AWS credentials and supports multiple profiles and regions.

PARAMETERS

--profile NAME

AWS profile to use.
--region REGION
AWS region (default: from config).
--cluster NAME
Default ECS cluster to view.
--service NAME
Default ECS service to view (requires --cluster).
--read-only
Start in read-only mode.
-c, --config-file FILE
Config file path (default: ~/.config/e1s/config.yml).
-r, --refresh SECONDS
Auto-refresh interval in seconds (default: 30, -1 to disable).
-s, --shell PATH
Shell for interactive exec (default: /bin/sh).
-d, --debug
Enable debug logging.
-l, --log-file FILE
Custom log file path.
-j, --json
Output logs in JSON format.
-v, --version
Display version and exit.
-h, --help
Display help and exit.

KEYBINDINGS

h/j/k/l

Vim-style navigation (left/down/up/right)
Enter
View resource details
/
Filter resources
ctrl-p
Switch AWS profile
ctrl-d
Exit interactive exec session
q
Quit
?
Show all keybindings

INSTALL

brew install e1s
nix profile install nixpkgs#e1s

CAVEATS

Requires AWS credentials with appropriate ECS permissions. Some operations require additional IAM permissions. Log streaming may incur AWS CloudWatch costs. Network connectivity to AWS required.

HISTORY

e1s was created as the ECS equivalent of k9s, bringing the powerful terminal-based management experience to AWS ECS users. It fills the gap for users managing containerized applications on ECS.

SEE ALSO

aws(1), k9s(1), docker(1)