93 lines
3.1 KiB
Plaintext
93 lines
3.1 KiB
Plaintext
$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.
|