aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/google.md20
1 files changed, 20 insertions, 0 deletions
diff --git a/docs/google.md b/docs/google.md
new file mode 100644
index 0000000..adf3de8
--- /dev/null
+++ b/docs/google.md
@@ -0,0 +1,20 @@
+# Running koushin with a Google account
+
+## Create an application password
+
+First, you'll need to obtain an application-specific password for koushin from
+the [app passwords] page on your Google account.
+
+## Run koushin
+
+Start koushin with these upstream URLs:
+
+ koushin imaps://imap.gmail.com smtps://smtp.gmail.com \
+ carddavs://www.googleapis.com/carddav/v1/principals/YOUREMAIL/
+
+Replace `YOUREMAIL` with your Google account's e-mail address.
+
+Once koushin is started, you can login with your e-mail address and the app
+password.
+
+[app passwords]: https://security.google.com/settings/security/apppasswords