From 193758ecff21c4ed8852b2a64d7b4b1562d4f7d9 Mon Sep 17 00:00:00 2001
From: Julien Dessaux
Date: Wed, 13 Mar 2019 13:32:21 +0100
Subject: Added README and LICENSE

---
 README.md | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 README.md

(limited to 'README.md')

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..bf4eb9c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,55 @@
+# Bastion
+
+SSH bastion that features transparent connection and session recording.
+
+This project is inspired by https://github.com/moul/sshportal. I wrote this implementation to work around the fact that I couldn't get the go ssh lib
+to work properly with non interactive sessions, the bug has been open for a long time and I tend to belive it cannot be fixed
+(https://github.com/moul/sshportal/issues/55). This one does work properly with non interactive sessions, which allows transparent ansible usage through
+the bastion.
+
+## Contents
+
+- [Dependencies](#dependencies)
+- [Installation and usage](#manual-installation)
+- [Usage](#usage)
+- [Docker](#docker)
+- [Monitoring](#monitoring)
+- [Backup](#backup)
+- [Scaling](#scaling)
+
+## Dependencies
+
+This project has only one hard dependency :
+- the libssh from https://www.libssh.org/. You should be able to use your distro's packages if they are recent enough.
+
+The following are optional dependencies :
+- the libtty from https://github.com/kilobyte/termrec which allows session recording.
+- compression libraries like libbz2, liblzma, libz allows to compress on the fly session records.
+- libmysql for now because it hosts the runtime config
+
+## Manual Installation
+
+This project is built using cmake :
+```
+mkdir build
+cd build
+cmake ..
+make
+make install
+```
+
+You can customise the build with the following cmake flags :
+- SESSION_RECORDING
+
+For exemple this disables session recording :
+`cmake .. -DSESSION_RECORDING=OFF`
+
+## Usage
+
+## Docker
+
+## Monitoring
+
+## Backup
+
+## Scaling
-- 
cgit v1.2.3