summaryrefslogtreecommitdiffstats
path: root/owncloud-README.fedora
blob: 41c2861609eb4bd15a0771cef1b2cb5120957968 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
ownCloud packaging notes
========================

Start
------
After installation you should be able to access the login/configuration page
at the following URL:

http://localhost/owncloud/ or http://localhost/

If not, make sure your webserver is running properly.

Webserver
---------
Currently ownCloud in Fedora supports httpd (Apache) and nginx. You must install
at least one webserver subpackage (owncloud-<webserver>). These packages
include additional configuration files for the webservers. Remote access is
disabled by default. To enable access from any host for Apache **AFTER** you
complete the initial setup process, do this:

ln -s /etc/httpd/conf.d/owncloud-access.conf.avail /etc/httpd/conf.d/z-owncloud-access.conf

If you wish to adjust any of the settings it is recommended that you create
a new configuration file that will override owncloud.conf, rather than editing
it, so future changes to the packaged file will be respected on your server.
If you do not do this, please be careful to check for changes in the packaged
configuration file (especially on major ownCloud upgrades) and merge into
your modified configuration as appropriate.

Database
--------
You can choose between three databases: MySQL, PostgreSQL and SQLite.
For each of them there is an ownCloud subpackage (owncloud-<database>).
You are required to install at least one of them. The packages only ensure
the necessary requirements to communicate with a database server of that type
are installed, they do not require the database server package itself, as
you may wish to use a remote database server. If you wish to use a local one,
you must ensure it is installed and configured.

For larger installs you should use MySQL or PostgreSQL.

If you choose MySQL or PostgreSQL, keep in mind that you must create a database
and user for ownCloud manually, before you can finish the setup process. The
README.postgresql and README.mysql files provide more details and help with
this.

Configuration
-------------
You can find the main configuration file at '/etc/owncloud/config.php'. Until
you first access the server it will be just a small stub containing settings
that differ in this package from the upstream defaults. After you first access
ownCloud, the initial setup process will populate it with some more settings.
Other settings that can be provided in this file are documented at:
https://doc.owncloud.org/server/8.0/admin_manual/configuration/config_sample_php_parameters.html

User Data
---------
The default data directory is '/var/lib/owncloud/data'. Every file that is
uploaded by your users to ownCloud gets saved into this folder. Consider doing
a backup of this directory, together with the database and the main
configuration. Note that if you change this location, you must set appropriate
ownership and SELinux context attributes.

Logging
-------
As specified by the configuration file, ownCloud sends messages to the system
logger, which means in a standard Fedora configuration it will log to the
systemd journal: try "journalctl -b | grep ownCloud". You can also change the
loglevel or switch to the built-in log mechanism of ownCloud.

App Store
---------
If you install additional third party apps using the built-in app store, you
can find them in the directory '/var/lib/owncloud/apps'. This functionality is
enabled by default.


For further information see http://owncloud.org/ and http://doc.owncloud.org/