-Nmhive is a webserver for nmbug, allowing you to remotely query and
-manage tags. There is also a bookmarklet that provides a convenient
-interface for managing tags while browsing Gmane_.
+Nmhive is a webserver for nmbug_, allowing you to remotely query and
+manage notmuch_ tags. There is also a bookmarklet that provides a
+convenient interface for managing tags while browsing Gmane_.
+Dependencies
+============
+
+* Flask_
+* Flask-Cors_
+
+The versions shouldn't matter too much, but I'm testing with Flask
+0.10.1 and Flask-Cors 1.9.0.
+
+Server setup
+============
+
+Launch the server with something like::
+
+ $ nmhive.py -H 0.0.0.0 -p 5000
+ * Running on http://0.0.0.0:5000/
+ …
+
+You can kill the server whenever you like (e.g. via ``ctrl+c``)
+without worrying about corrupting your local notmuch or nmbug
+databases.
+
+Then edit ``nmbug_server`` in ``nmbug.js`` to point at that interface.
+Serve ``nmbug.js`` and ``index.html`` somewhere. I serve them with
+Nginx_, but you use whatever you like, including `Python's`__
+`http.server`_ with something like::
+
+ $ python -m http.server 8000
+
+__ Python_
+
+Point your users to the served ``index.html`` so they can get the
+bookmarklet and read the instructions for using it.
+
+
+.. _nmbug: http://notmuchmail.org/nmbug/
+.. _notmuch: http://notmuchmail.org/
.. _Gmane: http://gmane.org/
+.. _Flask: http://flask.pocoo.org/
+.. _Flask-Cors: https://pypi.python.org/pypi/Flask-Cors/
+.. _Nginx: http://nginx.org/
+.. _Python: https://www.python.org/
+.. _http.server: https://docs.python.org/3/library/http.server.html