$OpenBSD: README,v 1.12 2012/10/26 12:09:13 ajacoutot Exp $

+-----------------------------------------------------------------------
| Running ${FULLPKGNAME} on OpenBSD
+-----------------------------------------------------------------------

ownCloud is installed under
    ${INSTDIR}

Post-installation instructions
==============================
With Apache, AllowOverride settings are required on the ${INSTDIR}
directory. You can configure this as follows:
    # ln -sf ${PREFIX}/conf/modules.sample/owncloud.conf ${PREFIX}/conf/modules

"allow_url_fopen" needs to be enabled in PHP using _one_ of the
following methods:
    1. ${SYSCONFDIR}/php-{MODPHP_VERSION}.ini
    allow_url_fopen = On
    2. /var/www/conf/httpd.conf (main server or VirtualHost)
    php_admin_value allow_url_fopen 1

The maximum upload size for files can be modified in
    ${INSTDIR}/.htaccess

When not using Apache, make _sure_ to set the data directory to a
location outside of the document root.

To finish the installation, point you browser to:
    http://<hostname>/owncloud/

Database Configuration
----------------------
ownCloud can work with a PostgreSQL, MySQL or SQLite3 database.
Support for SQLite3 is included with the main php package; to use
another database, the corresponding package needs to be installed:
    php-pdo_pgsql or php-pdo_mysql

When using SQLite, not further configuration is required. However, with
MySQL or PostgreSQL, the file ${INSTADIR}/config/config.sample.php will
need to be copied to ${INSTADIR}/config/config.php and configured
accordingly.

Cron job
--------
If "backgroundjobs" is configured to "Cron" (as opposed to "AJAX" or
"Webcron") in the Admin menu, a cron(8) job must be added to the root's
crontab(5):

*/5	*	*	*	*	${MODPHP_BIN} ${INSTDIR}/cron.php

LDAP User Backend
-----------------
If the LDAP user backend is enabled, the "php-ldap" package will need to
be installed.

Finishing and validating the installation
-----------------------------------------
Accessing http://<hostname>/owncloud with a Web browser will finish the
installation and create a new admin user.

Updating
========
Before updating to a new release, read:
    http://owncloud.org/support/upgrade/

When using a PostgreSQL or MySQL, the corresponding MDB2 php package
must be installed to properly upgrade the database:
    php-pgsql or php-mysql

WebDAV access
=============
The personnal WebDAV share can be accessed using the following URL (e.g.
with Nautilus, Thunar or Doplhin) and the corresponding user and
password for the share:
    http://<hostname>/files/webdav.php

NOTE that it is highly recommended to use SSL on the webserver so that
access is done over https instead of http.

Synchronization
===============
The "ocsync" package (net/ocsync) can be installed to synchronize local
files with ownCloud. e.g.
    $ ocsync /path/to/localdir ownclouds://<username>:<password>@<hostname>/files/webdav.php/remotedir/

Apps and dependencies
=====================
To keep dependencies to a minimum, not all dependencies for all
installed apps are enforced. It is the job of the administrator to
manually install required packages according to the non-default apps he
wants to enable.