From 32b01d729ea8c0e6ecd1bd1def909fc41156d405 Mon Sep 17 00:00:00 2001
From: Kali Kaneko <kali@leap.se>
Date: Thu, 14 Apr 2016 20:25:29 -0400
Subject: [docs] add note about login automation

---
 docs/dev/automating_login.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 docs/dev/automating_login.rst

(limited to 'docs')

diff --git a/docs/dev/automating_login.rst b/docs/dev/automating_login.rst
new file mode 100644
index 00000000..7017dd8e
--- /dev/null
+++ b/docs/dev/automating_login.rst
@@ -0,0 +1,21 @@
+.. _automating_login:
+
+Automating login
+================
+
+There's an annoying bug with python keyring module, that makes the 'remember
+login' checkbox non functional.
+
+That, and the need to script end-to-end tests with the client inside a docker
+environment, made us put a mechanism to pass credentials via environment
+variables.
+
+To automate login, set BITMASK_CREDENTIALS env var::
+
+  BITMASK_CREDENTIALS=/tmp/secrets.conf bitmask --debug
+
+where the pointed file looks like this::
+
+  [Credentials]
+  username = user@provider
+  password = mypass
-- 
cgit v1.2.3