Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jordanhillis/ssha

SSH Alias (ssha) is a program for macOS and Linux users to easily connect to all your SSH servers.
https://github.com/jordanhillis/ssha

application linux python python-3 python3 script ssh ssh-client ssh-keys ssh-server

Last synced: 2 months ago
JSON representation

SSH Alias (ssha) is a program for macOS and Linux users to easily connect to all your SSH servers.

Awesome Lists containing this project

README

        

![SSHA](https://i.imgur.com/LOFpfJ8.png)

[![License: MIT](https://img.shields.io/badge/License-MIT-brightgreen.svg)](https://opensource.org/licenses/MIT)

### About:
SSH Alias is a program for Linux and macOS users to easily connect to all your SSH servers.
Add, edit, and remove aliases to connect to so that you never have to remember the hostname/IP, port, key file location and other various settings while connecting via SSH.

### Features:
- Saves SSH configurations as aliases
- Remembers key locations and other SSH options
- Supports SSH+Mosh
- Tests latency of your SSH connection
- Connects with alias name on shell
- Command line interface for adding, editing and removing aliases
- Supports Linux and macOS

### Latest Version:
* v1.0

### Installation:

SSH Alias requires [Python](https://www.python.org/downloads/) v3+, SSH and Linux/macOS to run.

#### Linux
Install on entire system:
```bash
git clone https://github.com/jordanhillis/ssha.git
cd ssha
sudo python3 -m pip install -r requirements.txt
sudo cp ssha.py /usr/bin/ssha
sudo chmod a+x /usr/bin/ssha
ssha
```
Install for single user:
```bash
git clone https://github.com/jordanhillis/ssha.git
cd ssha
python3 -m pip install -r requirements.txt
mkdir ~/.ssh
cp ssha.py ~/.ssh/ssha
chmod a+x ~/.ssh/ssha
echo "alias ssha='~/.ssh/ssha'" >> ~/.bashrc
source ~/.bashrc
ssha
```
#### macOS
Install on entire system:
```bash
git clone https://github.com/jordanhillis/ssha.git
cd ssha
sudo python3 -m pip install -r requirements.txt
sudo cp ssha.py /usr/local/bin/ssha
sudo chmod a+x /usr/local/bin/ssha
ssha
```
Install for single user:
```bash
git clone https://github.com/jordanhillis/ssha.git
cd ssha
python3 -m pip install -r requirements.txt
mkdir ~/.ssh
cp ssha.py ~/.ssh/ssha
chmod a+x ~/.ssh/ssha
echo "alias ssha='~/.ssh/ssha'" >> ~/.bash_profile
source ~/.bash_profile
ssha
```

### Usage:

| SSHA Internal Commands | About |
| ------ | ------ |
| c,conn,connect ALIAS | Connect to a configured alias|
| a,add ALIAS | Add an alias to use for connections |
| e,edit ALIAS | Edit an already configured alias |
| d,del,delete,rm ALIAS | Remove an alias from the connection list |
| l,ls,list | List all the configured alias connections |
| q,exit,quit | Exit the program |
| h,help | Display help screen |

To quickly connect to a preconfigured alias you can run the command
```bash
ssha SERVERNAME
```
Replace SERVERNAME with the name of the alias that you would like to connect to.

### Example Usage:
##### Adding an alias
![Adding alias](http://i.imgur.com/AVgECIH.png)

##### Alias list
![Alias list](http://i.imgur.com/UIJQDMI.png)

##### Connecting to an alias
![Connecting to alias](http://i.imgur.com/uj5OVJ8.png)

##### Quick connect to an alias via shell
![Quick connect to alias](https://i.imgur.com/kmNhgES.png)

### Developers:
- Jordan Hillis - *Lead Developer*

### License:
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details