e2s 0.1.2

A TUI for managing AWS EC2 SSH access
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

## 📦 Installation


### Linux & macOS


```bash
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/sandeshgrangdan/e2s/releases/download/v0.1.2/e2s-installer.sh | sh
```

### Windows


```powershell
powershell -c "irm https://github.com/sandeshgrangdan/e2s/releases/download/v0.1.2/e2s-installer.ps1 | iex"
```

### Cargo


```bash
cargo install e2s
```

## 🔧 Prerequisites


Before using EC2 TUI, ensure you have:

1. **SSH Keys Setup** - Your SSH keys must be configured in `~/.ssh/` directory
2. **AWS Credentials** - Valid AWS credentials configured (via AWS CLI or environment variables)
3. **Network Access** - Ability to reach your EC2 instances via SSH

## ⚙️ [Optional] Configuration 


EC2 TUI uses a TOML configuration file located at `~/.config/e2s/config.toml`.

### Example Configuration


```toml
[users]
# Default user - will be auto-selected when app starts

# If not specified, the first user in the list will be selected

default_user = "ubuntu"

# Additional SSH users for different EC2 instances

# Common users for different Linux distributions:

# - Amazon Linux: ec2-user

# - Ubuntu: ubuntu

# - Debian: admin or debian

# - CentOS/RHEL: centos or ec2-user

# - Rocky Linux: rocky

additional_users = [
    "admin",
    "root",
    "centos",
    "debian",
    "fedora",
    "rocky",
    "azureuser",  # For Azure VMs
    "bitnami",    # For Bitnami instances
]

[keys]
# Use just the filename if the key is in ~/.ssh/
default_key = "dev-key.pem"
# OR use the full path:
# default_key = "/home/sandesh/.ssh/eclat-dev1.pem"

# Additional keys from other locations (optional)

additional_keys = [
    "/home/sandesh/custom/another_key.pem",
    "~/Documents/keys/work_key"
]
```

### Configuration Options


- **`default_user`** - The SSH user that will be pre-selected when the application starts
- **`additional_users`** - List of additional SSH users to choose from when connecting to instances

## 🎯 Usage


Simply run the command:

```bash
e2s
```

The TUI will launch and display all your EC2 instances. Navigate through the list and select an instance to SSH into it.

## 🗺️ Common SSH Users by Distribution


| Distribution | Default User |
|-------------|--------------|
| Amazon Linux | `ec2-user` |
| Ubuntu | `ubuntu` |
| Debian | `admin` or `debian` |
| CentOS/RHEL | `centos` or `ec2-user` |
| Rocky Linux | `rocky` |
| Fedora | `fedora` |
| Bitnami AMIs | `bitnami` |