Files
nextcloud-docs/admin_manual/installation.rst
2012-10-27 12:47:15 +02:00

95 lines
3.3 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
Installation
============
.. todo:: Update the dependencies to 4.5 dependencies
To run ownCloud, your webserver must have the following installed:
* php5 (>= 5.3)
* php5-json
* php-xml
* php-mbstring
* php5-zip
* php5-gd
And as *optional* dependencies:
* php5-sqlite (>= 3)
* curl
* libcurl3
* libcurl3-dev
* php5-curl
* php-pdo
Commands for Ubuntu and Debian:
.. todo:: Document other distros (Windows, Mac?)
::
apt-get install apache2 php5 php5-json php-xml php-mbstring php5-zip php5-gd
apt-get install php5-sqlite curl libcurl3 libcurl3-dev php5-curl php-pdo
You dont need any WebDAV support of your webserver (i.e. apaches mod_webdav)
to access your ownCloud data via WebDAV, ownCloud has a WebDAV server built in.
Extract ownCloud and copy to your webserver
-------------------------------------------
::
tar -xjf path/to/downloaded/owncloud-x.x.x.tar.bz2
cp -r owncloud /path/to/your/webserver
Set the directory permissions
-----------------------------
The owner of your webserver must own the apps/, data/ and config/ directories
in your ownCloud install. You can do this by running the following command for
the apps, data and config directories:
::
chown -R www-data:www-data /path/to/your/owncloud/install/data
Replace ``www-data:www-data`` with the user and group of the owner of your
webserver.
.. note:: The ``data/`` directory will only be created after setup has run
(see below) and is not present by default in the tarballs.
Enable .htaccess and mod_rewrite if running apache
--------------------------------------------------
If you are running the apache webserver, it is recommended that you enable
``.htaccess`` files as ownCloud uses them to enhance security and allows
you to use webfinger. To enable .htaccess files you need to ensure that
``AllowOverride`` is set to ``All`` in the ``Directory /var/www/`` section of
your virtual host file. This is usually in ``/etc/apache2/sites-enabled/000-default``.
You should also run ``a2enmod rewrite`` and ``a2enmod headers``. Then restart
apache: service apache2 restart (for Ubuntu systems). In order for the maximum
upload size to be configurable, the .htaccess file in the owncloud folder needs
to be made writable by the server.
Follow the install wizard
-------------------------
Open your web browser and navigate to your ownCloud instance. If you are
installing ownCloud on the same machine as you will access the install
wizard from, the url will be: http://localhost/ (or http://localhost/owncloud).
For basic installs we recommend SQLite as it is easy to setup (ownCloud will do
it for you). For larger installs you should use MySQL or PostgreSQL. Click on the
Advanced options to show the configuration options. You may enter admin
credentials and let ownCloud create its own database user, or enter a
preconfigured user. If you are not using apache as the webserver, please set
the data directory to a location outside of the document root. See the advanced
install settings.
Finished!
---------
Login and start using ownCloud! For more details on configuring
your ownCloud, please visit the Support Centre. If you plan on using the
Webfinger app and your ownCloud installation is not in the webroot then youll
have to manually link ``/var/www/.well-known`` to
``/path/to/your/owncloud/.well-known``.