= Owncloud =

Our [wiki:owncloud owncloud] installation is running on lucius, which is currently running Debian jessie. The owncloud package, however, comes from the [https://download.owncloud.org/download/repositories/stable/owncloud/ ownCloud repo] (see #11039).

== Important details ==

 * As per the Debian packaging, it is run as the www-data user
 * Directories:
  * The code is in /var/www/owncloud. 
  * The data (files) are in /var/lib/owncloud/data. 
  * Our theme is in /var/lib/owncloud/themes (symlinked from /var/www/owncloud/themes)
  * Our configuratio is in /etc/owncloud (symlinked from /var/www/owncloud/config)
 * We're using the postgres package not the mysql package. If you want to muck around in the database: `su - www-data` and then `psql owncloud`
 * We're authenticating using the [wiki:login-service login-service] (web api). 
  * User accounts are created on the fly. 
  * This code is in the /etc/owncloud/config.php file (and must be re-copied when admin config changes are applied).
  * The code has to stay in config.php or it won't work in all cases (I tried to make a third party app with this code - but the third party app is not invoked withn you download the ics version of the calendar).
  * This is a real pain.
 * The admin username and password are in [wiki:keyringer keyringer]. However, try to avoid logging in as the admin, and if you change any configuration options, /etc/owncloud/config.php may get overwritten (which contains our custom user backend). A copy should be available at /etc/owncloud/config.php.bak
 * A 5GB per user quota is set. This is configured by logging in as admin and then clicking to administer users. Quotas can be changed on a per user basis.
 * To fix #8125, we've added our own custom theme called "mayfirst", which is in lucius.mayfirst.org:/var/lib/owncloud/themes and it is activated via the theme => "mayfirst" line in lucius.mayfirst.org:/etc/owncloud/config.php. Currently, it only adds a style sheet that simply hides the password change form.
 * We have committed to maintaining four extra apps, which are installed in /var/lib/owncloud/apps-local:
  * [https://apps.owncloud.com/content/show.php/Documents?content=168711 Documents]
  * [https://apps.owncloud.com/content/show.php/Calendar?content=168707 Calendar]
  * [https://apps.owncloud.com/content/show.php/Contacts?content=168708 Contacts]
  * [https://apps.owncloud.com/content/show.php/grauphel+-+Tomboy+sync+server?content=166654 Grauphel] (see #10305)
  * [https://apps.owncloud.com/content/show.php/Bookmarks?content=168710 Bookmarks] (see #10696)


== Upgrading ==

When upgrading between minor versions (8.1.1 to 8.1.2) run `apt-get dist-upgrade`. 

To ensure all database udpates have been run, su to the www-data user and then:
{{{
cd /var/www/owncloud
php occ upgrade
}}}

Be sure to check /etc/owncloud/config.php to make sure it has the OC_User_mfpl class defined. If not, compare config.php with config.php.bak and update config.php as needed.

When upgrading between major versions you most likely will have to download the corresponding version of the third party apps we are maintaining. Best practice seems to be:

 * Enter maintenance mode (edit to /etc/owncloud/config.php
 * Download all apps in /var/lib/owncloud/apps-local, replacing the existing apps with the new ones.
 * Run `apt-get dist-upgrade`
 * `su - www-data && cd /var/www/owncloud && php occ upgrade`
 * Fix /etc/owncloud/config.php to include our custom class.