From: Jason Owen <jason@jasonaowen.net>
Date: Sat, 19 Oct 2019 00:06:53 +0000 (-0700)
Subject: Add installation notes
X-Git-Url: https://code.communitydata.science/nu-vpn-proxy.git/commitdiff_plain/70f96b0f2d19057d4c122f5cdb6a58aa809e8088?hp=f923c1247c40994eccdf429cccb6a7b0e22ffd2b

Add installation notes

Add some instructions on how to install the dependencies needed to use
this tool.
---

diff --git a/README.md b/README.md
index 6df9f5d..aa94778 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,27 @@ Interactive login is, unfortunately, sometimes a necessary alternative to automa
 login via scripts such as
 [zdave/openconnect-gp-okta](https://github.com/zdave/openconnect-gp-okta).
 
+Installation
+============
+
+gp-saml-gui uses GTK, which requires Python 3 bindings.
+
+On Debian / Ubuntu, these are packaged as `python3-gi`, `gir1.2-gtk-3.0`, and
+`gir1.2-webkit2-4.0`:
+
+```
+$ sudo apt install python3-gi gir1.2-gtk-3.0 gir1.2-webkit2-4.0
+```
+
+Then, set up a virtual environment that can access these system packages,
+activate it, and install the Python dependencies:
+
+```
+$ virtualenv --python=python3 --system-site-packages venv
+$ . venv/bin/activate
+$ pip install requests
+```
+
 How to use
 ==========
 
@@ -45,7 +66,6 @@ TODO
 ====
 
 * Packaging
-* Explain dependencies
 
 License
 =======