From c2dfb8c01bb6e09140ef0a56f65fd6bd1e1baabd Mon Sep 17 00:00:00 2001
From: Steven L <steven.leibrock@gmail.com>
Date: Thu, 23 Apr 2020 15:29:41 -0400
Subject: [PATCH] Start of a new page about downloading/building ssh-chat

---
 Getting-ssh-chat.md | 45 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 Getting-ssh-chat.md

diff --git a/Getting-ssh-chat.md b/Getting-ssh-chat.md
new file mode 100644
index 0000000..39091b5
--- /dev/null
+++ b/Getting-ssh-chat.md
@@ -0,0 +1,45 @@
+`ssh-chat` can be downloaded as a release from the [Releases](https://github.com/shazow/ssh-chat/releases) section, or it can be built from source using `go` and `gnumake`. Steps for both will be mentioned on this page.
+
+# Downloading `ssh-chat`
+
+Upon visiting the [Releases](https://github.com/shazow/ssh-chat/releases) section, you will see a series of version numbers with changelog information, followed by some attachments. These zipped up files contain binary releases of `ssh-chat` that you can download without having to build from source.
+
+There are a few to pick from, so be sure to match whatever operating system you are using and to match your architecture. In this example, we are using an `amd64` Linux system, so we will use `ssh-chat-linux_amd64.tgz`. You can click on the link to download through your browser and unzip yourself with an appropriate archive manager. In order to do this through command line, we will use `curl` and `tar`.
+
+```bash
+$ curl -L https://github.com/shazow/ssh-chat/releases/download/v1.9/ssh-chat-linux_amd64.tgz > ssh_chat.tgz
+$ tar zxvf ssh_chat.tgz && cd ssh-chat
+$ ./ssh-chat
+```
+
+# Building `ssh-chat` from source
+
+Below are instructions with example output (commands start with a $)
+```bash
+$ git clone https://github.com/shazow/ssh-chat && cd ssh-chat
+Cloning into 'ssh-chat'...
+remote: Enumerating objects: 136, done.
+remote: Counting objects: 100% (136/136), done.
+remote: Compressing objects: 100% (91/91), done.
+remote: Total 2349 (delta 67), reused 81 (delta 37), pack-reused 2213
+Receiving objects: 100% (2349/2349), 529.06 KiB | 5.24 MiB/s, done.
+Resolving deltas: 100% (1545/1545), done.
+
+$ go version
+go version go1.14.2 linux/amd64
+
+$ make
+go build -ldflags "-X main.Version=v1.9-3-g403bb59 -extldflags "-static"" ./cmd/ssh-chat
+go: downloading github.com/alexcesaro/log v0.0.0-20150915221235-61e686294e58
+go: downloading github.com/jessevdk/go-flags v1.4.0
+go: downloading github.com/shazow/rateio v0.0.0-20200113175441-4461efc8bdc4
+go: downloading golang.org/x/text v0.3.2
+go: downloading golang.org/x/crypto v0.0.0-20200420104511-884d27f42877
+go: downloading golang.org/x/sys v0.0.0-20200420163511-1957bb5e6d1f
+go: downloading github.com/howeyc/gopass v0.0.0-20190910152052-7cb4b85ec19c
+
+$ ./ssh-chat
+Listening for connections on [::]:2022
+```
+
+Once downloaded from a release or built from source, you will have a `ssh-chat` binary that you can install in whatever location you see fit.