============
Introduction
============

Welcome to the ownCloud Administrator Guide.  This guide describes
administrator tasks for ownCloud; a flexible, open source, file synchronization
and sharing solution. ownCloud is comprised of a server running on either a
Linux or Microsoft Windows platform as well as client applications for Microsoft
Windows, Mac OS X and Linux (Desktop Client) and mobile clients for both the
Android and Apple iOS operating system.

Target Audience
---------------

This guide is targeted towards people who want to install, administer, and
optimize the ownCloud server. If you want to learn more about the ownCloud Web
user interface or how to install clients on the server, refer to the following:

* `User Manual`_
* `Desktop Client Manual`_

.. _`User Manual`: http://doc.owncloud.com/
.. _`Desktop Client Manual`: http://doc.owncloud.com/

ownCloud Videos and Blogs
-------------------------

See the `official ownCloud channel 
<https://www.youtube.com/channel/UC_4gez4lsWqciH-otOlXo5w>`_ and `ownClouders 
community channel <https://www.youtube.com/channel/UCA8Ehsdu3KaxSz5KOcCgHbw>`_ 
on YouTube for tutorials, overviews, and conference videos.

Visit `ownCloud Planet <https://owncloud.org/news/>`_ for news and developer 
blogs.

Document Structure
------------------

This document is broken out into three major sections -- Installation, Configuration, and 
Maintenance.  The Issues sections has instructions for reporting bugs. The following 
sections provide detailed information about various tasks associated with each of these 
sections.

Installation
============
This section provides detailed instructions on how to install ownCloud in
different scenarios.  It contains the following topics:

* :doc:`installation/appliance_installation`
* :doc:`installation/apps_management_installation`
* :doc:`installation/hiawatha_configuration`
* :doc:`installation/installation_wizard`
* :doc:`installation/lighttpd_configuration`
* :doc:`installation/linux_installation` (recommended)
* :doc:`installation/macos_installation` (not supported)
* :doc:`installation/nginx_configuration`
* :doc:`installation/others_installation`
* :doc:`installation/source_installation`
* :doc:`installation/ucs_installation`
* :doc:`installation/windows_installation`
* :doc:`installation/yaws_configuration`
* :doc:`installation/selinux_configuration`

.. note:: If you just want to try out ownCloud in a virtual machine, without any 
   configuration, refer to :doc:`installation/appliance_installation`.  For your 
   convenience, this topic contains ready-to-use images.

Configuration
=============
This section describes how to configure ownCloud and your Web server.  It
contains the following topics:

* :doc:`configuration/antivirus_configuration`
* :doc:`configuration/automatic_configuration`
* :doc:`configuration/background_jobs_configuration`
* :doc:`configuration/big_file_upload_configuration`
* :doc:`configuration/collaborative_documents_configuration`
* :doc:`configuration/config_sample_php_parameters`
* :doc:`configuration/custom_client_configuration`
* :doc:`configuration/database_configuration`
* :doc:`configuration/email_configuration`
* :doc:`configuration/external_storage_configuration_gui`
* :doc:`configuration/external_storage_configuration`
* :doc:`configuration/file_sharing_configuration`
* :doc:`configuration/files_locking_enabling`
* :doc:`configuration/js_css_asset_management_configuration`
* :doc:`configuration/knowledgebase_configuration`
* :doc:`configuration/language_configuration`
* :doc:`configuration/logging_configuration`
* :doc:`configuration/previews_configuration`
* :doc:`configuration/reverse_proxy_configuration`
* :doc:`configuration/search_configuration`
* :doc:`configuration/encryption_configuration`
* :doc:`configuration/server_to_server_configuration`
* :doc:`configuration/serving_static_files_configuration`
* :doc:`configuration/thirdparty_php_configuration`
* :doc:`configuration/user_auth_ftp_smb_imap`
* :doc:`configuration/user_auth_ldap`
* :doc:`configuration/user_auth_ldap_cleanup`
* :doc:`configuration/user_configuration`
* :doc:`configuration/reset_admin_password`

Maintenance
===========

This sections describes the maintenance tasks associated with the ownCloud
server (for example, updating or migrating to a new version of ownCloud).  It
contains the following topics:

* :doc:`maintenance/backup`
* :doc:`maintenance/convert_db`
* :doc:`maintenance/enable_maintenance`
* :doc:`maintenance/migrating`
* :doc:`maintenance/restore`
* :doc:`maintenance/update`
* :doc:`maintenance/upgrade`

Issues
======

What to do when you have problems, and where to report bugs.

* :doc:`issues/index`