diff --git a/admin_manual/index.rst b/admin_manual/index.rst index 364101952..c7cf1f02d 100644 --- a/admin_manual/index.rst +++ b/admin_manual/index.rst @@ -10,6 +10,8 @@ Contents :maxdepth: 2 introduction + installation + update .. add more chapters diff --git a/admin_manual/installation.rst b/admin_manual/installation.rst new file mode 100644 index 000000000..7dd9379fb --- /dev/null +++ b/admin_manual/installation.rst @@ -0,0 +1,94 @@ +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 don’t need any WebDAV support of your webserver (i.e. apache’s 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 you’ll +have to manually link ``/var/www/.well-known`` to +``/path/to/your/owncloud/.well-known``. diff --git a/admin_manual/update.rst b/admin_manual/update.rst new file mode 100644 index 000000000..646b1cef8 --- /dev/null +++ b/admin_manual/update.rst @@ -0,0 +1,45 @@ +Updating ownCloud +================= + +Update +------ + +Update is to bring an ownCloud instance to its latest *point release*, e.g. +ownCloud 4.0.6 → 4.0.7.To update an ownCloud installation manually, follow +those steps: + +1. Do a backup. +2. Unpack the release tarball in the owncloud directory, i.e. copy all new + files into the ownCloud installation. +3. Make sure that the file permissions are correct. +4. With the next page request the update procedures will run. +5. If you installed ownCloud from a repository, your package management + should take care of it. + +Upgrade +------- + +Upgrade is to bring an ownCloud instance to a new *major release*, e.g. +ownCloud 4.0.7 → 4.5.0. Always do backups anyway. + +To upgrade ownCloud, follow those steps: + +1. Make sure that you ran the latest point release of the major ownCloud + version, e.g. 4.0.7 in the 4.0 series. If not, update to that version first + (see above). +2. Do a backup. +3. Deactivate all third party applications. +4. Delete everything from your ownCloud installation directory, except data and + config. +5. Unpack the release tarball in the owncloud directory (or copy the + files thereto). +6. Make sure that the file permissions are correct. +7. With the next page request the update procedures will run. +8. If you had 3rd party applications, check if they provide versions compatible + with the new release. + +If so, install and enable them, update procedures will run if needed. 9. If +you installed ownCloud from a repository, your package management should take +care of it. Probably you will need to look for compatible third party +applications yourself. Always do backups anyway. +