From 56c9a68c8292cf6ec8cef50ce5eb6af2e0009246 Mon Sep 17 00:00:00 2001 From: Christopher Usher Date: Wed, 21 Aug 2019 15:54:27 -0700 Subject: [PATCH] Draft of an installation guide for the wubloader --- INSTALL.md | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 INSTALL.md diff --git a/INSTALL.md b/INSTALL.md new file mode 100644 index 0000000..5ac5a4b --- /dev/null +++ b/INSTALL.md @@ -0,0 +1,56 @@ +This is a guide on how to get the wubloader running. + +All of the wubloader components are built as docker images and the provided docker-compose file can be used. + +This installation guide is written assuming you are on a Linux-like operating system. + +## Requirements +* `bash` + +* `docker` + + https://docs.docker.com/install/ + +* `docker-compose` + + https://docs.docker.com/compose/install/ + + + +## Download the wubloader + +You can download the latest version of the wubloader from github: + + https://github.com/ekimekim/wubloader/archive/master.zip + +Alternatively if you have `git` installed you can clone the git repository: + + `git clone https://github.com/ekimekim/wubloader` + + +## Generate the docker-compose file + +You can edit the `docker-compose.jsonnet` file to set the configuration options. Important options include: + +* `channel`, the Twitch channel to capture from +* `segments_path`, the local path to save segements to +* TODO add more + +To generate the `docker-compose.yml` file used by `docker-compose`, run `generate-docker-compose` + + `bash generate-docker-compose` + +After making any changes to `docker-compose.jsonnet`, you will need to rerun `generate-docker-compose`. + +## Running the wubloader + +To start the wubloader, simply run + + `docker-compose up` + +To stop the wubloader and clean up, simply run + + `docker-compose down` + + +TODO what ports need to be exposed ....