Skip to content
This repository has been archived by the owner on Sep 25, 2021. It is now read-only.

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
alash3al authored Sep 8, 2017
1 parent 90e84e6 commit ae9d4db
Showing 1 changed file with 31 additions and 1 deletion.
32 changes: 31 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,32 @@
# dockssh
# Dockssh
Dockssh, ssh into any container from anywhere

# Why
- For learning and fun
- For testing/staging/development environments

# How it works
- `Dockssh` runing on port `22022` on host `example.com`
- A user connects to `dockssh` i.e `ssh -p 22022 container1@example.com`
- `Dockssh` checks if the user provided password is the same as the one stored in redis key `dockssh:container1:pass`
- On success, `Dockssh` will open a `PTY` (pseudotty) to `docker exec -it container1 /bin/sh`
- Have fun ^^! (replace `container1` with any of your containers)

# Why redis for configurations
- No configurations files
- Simple & tiny
- Makes `Dockssh` loads configurations in realtime, no need to restart

# Requirements
- Linux
- Docker
- Redis

# Downloads
Download the binary from [here](#)

# Building from source
`go get github.com/alash3al/dockssh`

# Usage
`./dockssh --help`

0 comments on commit ae9d4db

Please sign in to comment.