Move to Hugo

content/post/2014-12-09-zotero.md

@@ -0,0 +1,109 @@
+---
+title: Zotero
+date: 2014-12-09 12:12:12
+tags:
+  - zotero
+  - webdav
+  - nginx
+  - apache
+---
+
+[Zotero](https://www.zotero.org/) is an Open Source tool that lets you
+organise your bibliography, syncing it with the cloud. Unlike other
+alternatives such as [Mendeley](http://www.mendeley.com), Zotero can
+upload the attachments and data to a private cloud via WebDav.
+
+If you use nginx as your web server, know that even though it provides
+partial support for webdav, Zotero needs more than that. Hence, you will
+need another webdav server, and optionally let nginx proxy to it. This
+short post provides the basics to get that set-up working under
+Debian/Ubuntu.
+
+Setting up Apache
+-----------------
+
+First we need to install Apache:
+
+```bash
+sudo apt-get install apache2
+```
+
+Change the head of "/etc/apache2/sites-enabled/000-default" to:
+
+```apache
+<VirtualHost *:880>
+```
+
+Then, create a file /etc/apache2/sites-available/webdav:
+
+```apache
+Alias /dav /home/webdav/dav
+<Location /dav>
+    Dav on
+    Order Allow,Deny
+    Allow from all
+    Dav On
+    Options +Indexes
+    AuthType Basic
+    AuthName DAV
+    AuthBasicProvider file
+    AuthUserFile /home/webdav/.htpasswd
+    Require valid-user
+</Location>
+```
+
+Ideally, you want your webdav folders to be private, adding
+authentication to them. So you need to create the webdav and zotero
+users and add the passwords to an htpasswd file. Even though you could
+use a single user, since you will be configuring several clients with
+your credentials I encourage you to create the zotero user as well. This
+way you can always change the password for zotero without affecting any
+other application using webdav.
+
+```bash
+sudo adduser webdav
+sudo htpasswd -c /home/webdav/.htpasswd webdav
+sudo htpasswd /home/webdav/.htpasswd zotero
+sudo mkdir -p /home/webdav/dav/zotero
+```
+
+Enable the site and restart apache:
+
+```bash
+sudo a2enmod webdav
+sudo a2enmod dav_fs
+sudo a2ensite webdav
+sudo service apache2 restart
+```
+
+At this point everything should be working at
+<http://><your_host>:880/dav/zotero
+
+Setting up NGINX
+----------------
+
+After the Apache side is working, we can use nginx as a proxy to get
+cleaner URIs. In your desired site/location, add this:
+
+```nginx
+location /dav {
+    client_max_body_size 20M;
+    proxy_set_header X-Real-IP  $remote_addr;
+    proxy_set_header X-Forwarded-For $remote_addr;
+    proxy_set_header Host $host;
+    proxy_pass http://127.0.0.1:880;
+}
+```
+
+Now just reload nginx:
+
+```bash
+sudo service nginx force-reload
+```
+
+Extras
+------
+
+-   [Zotero Reader](http://zoteroreader.com/) - HTML5 client
+-   [Zandy](https://github.com/ajlyon/zandy) - Android Open Source
+    client