Skip to content

Latest commit

 

History

History
106 lines (89 loc) · 2.92 KB

README.md

File metadata and controls

106 lines (89 loc) · 2.92 KB

SSHA

License: 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 v3+, SSH and Linux/macOS to run.

Linux

Install on entire system:

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:

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:

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:

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

ssha SERVERNAME

Replace SERVERNAME with the name of the alias that you would like to connect to.

Example Usage:

Adding an alias

Adding alias

Alias list

Alias list

Connecting to an alias

Connecting to alias

Quick connect to an alias via shell

Quick connect to alias

Developers:

  • Jordan Hillis - Lead Developer

License:

This project is licensed under the MIT License - see the LICENSE.md file for details