ownCloud 9.0 User Manual

ownCloud fully supports the WebDAV protocol, and you can connect and synchronize with your ownCloud files over WebDAV. In this chapter you will learn how to connect Linux, Mac OS X, Windows, and mobile devices to your ownCloud server via WebDAV. Before we get into configuring WebDAV, let’s take a quick look at the recommended way of connecting client devices to your ownCloud servers.

ownCloud Desktop and Mobile Clients¶

The recommended method for keeping your desktop PC synchronized with your ownCloud server is by using the ownCloud Desktop Client. You can configure the ownCloud client to save files in any local directory you want, and you choose which directories on the ownCloud server to sync with. The client displays the current connection status and logs all activity, so you always know which remote files have been downloaded to your PC, and you can verify that files created and updated on your local PC are properly synchronized with the server.

The recommended method for syncing your ownCloud server with Android and Apple iOS devices is by using the ownCloud mobile apps.

To connect to your ownCloud server with the ownCloud mobile apps, use the base URL and folder only:

In addition to the mobile apps provided by ownCloud, you can use other apps to connect to ownCloud from your mobile device using WebDAV. WebDAV Navigator is a good (proprietary) app for Android devices, iPhones, and BlackBerry devices. The URL to use on these is:

WebDAV Configuration¶

If you prefer, you may also connect your desktop PC to your ownCloud server by using the WebDAV protocol rather than using a special client application. Web Distributed Authoring and Versioning (WebDAV) is a Hypertext Transfer Protocol (HTTP) extension that makes it easy to create, read, and edit files on Web servers. With WebDAV you can access your ownCloud shares on Linux, Mac OS X and Windows in the same way as any remote network share, and stay synchronized.

In the following examples, You must adjust example.com/ to the URL of your ownCloud server installation.

Accessing Files Using Linux¶

You can access files in Linux operating systems using the following methods.

Nautilus File Manager¶

Use the davs:// protocol to connect the Nautilus file manager to your ownCloud share:

If your server connection is not HTTPS-secured, use dav:// instead of davs:// .

Accessing Files with KDE and Dolphin File Manager¶

To access your ownCloud files using the Dolphin file manager in KDE, use the webdav:// protocol:

You can create a permanent link to your ownCloud server:

1. Open Dolphin and click “Network” in the left hand “Places” column.
2. Click on the icon labeled Add a Network Folder. The resulting dialog should appear with WebDAV already selected.
3. If WebDAV is not selected, select it.
4. Click Next.
5. Enter the following settings:
   • Name: The name you want to see in the Places bookmark, for example ownCloud.
   • User: The ownCloud username you used to log in, for example admin.
   • Server: The ownCloud domain name, for example example.com (without http:// before or directories afterwards).
   • Folder – Enter the path owncloud/remote.php/dav/files/USERNAME/ .
6. (Optional) Check the “Create icon checkbox” for a bookmark to appear in the Places column.
7. (Optional) Provide any special settings or an SSL certificate in the “Port & Encrypted” checkbox.

Creating WebDAV Mounts on the Linux Command Line¶

You can create WebDAV mounts from the Linux command line. This is useful if you prefer to access ownCloud the same way as any other remote filesystem mount. The following example shows how to create a personal mount and have it mounted automatically every time you log in to your Linux computer.

Install the davfs2 WebDAV filesystem driver, which allows you to mount WebDAV shares just like any other remote filesystem. Use this command to install it on Debian/Ubuntu:

Use this command to install it on CentOS, Fedora, and openSUSE:

Add yourself to the davfs2 group:

Then create an owncloud directory in your home directory for the mountpoint, and .davfs2/ for your personal configuration file:

Copy /etc/davfs2/secrets to

Set yourself as the owner and make the permissions read-write owner only:

Add your ownCloud login credentials to the end of the secrets file, using your ownCloud server URL and your ownCloud username and password:

Add the mount information to /etc/fstab :

Then test that it mounts and authenticates by running the following command. If you set it up correctly you won’t need root permissions:

You should also be able to unmount it:

Now every time you login to your Linux system your ownCloud share should automatically mount via WebDAV in your

/owncloud directory. If you prefer to mount it manually, change auto to noauto in /etc/fstab .

Known Issues¶

Problem¶

Resource temporarily unavailable

Solution¶

If you experience trouble when you create a file in the directory, edit /etc/davfs2/davfs2.conf and add:

Problem¶

Solution¶

If you use a self-signed certificate, you will get a warning. To change this, you need to configure davfs2 to recognize your certificate. Copy mycertificate.pem to /etc/davfs2/certs/ . Then edit /etc/davfs2/davfs2.conf and uncomment the line servercert . Now add the path of your certificate as in this example:

Accessing Files Using Mac OS X¶

The Mac OS X Finder suffers from a series of implementation problems and should only be used if the ownCloud server runs on Apache and mod_php, or Nginx 1.3.8+.

To access files through the Mac OS X Finder:

1. Choose Go > Connect to Server.

1. Specify the address of the server in the Server Address field.

For example, the URL used to connect to the ownCloud server from the Mac OS X Finder is:

For added details about how to connect to an external server using Mac OS X, check the vendor documentation

Accessing Files Using Microsoft Windows¶

It is best to use a suitable WebDAV client from the WebDAV Project page .

If you must use the native Windows implementation, you can map ownCloud to a new drive. Mapping to a drive enables you to browse files stored on an ownCloud server the way you would files stored in a mapped network drive.

Using this feature requires network connectivity. If you want to store your files offline, use the ownCloud Desktop Client to sync all files on your ownCloud to one or more directories of your local hard drive.

Prior to mapping your drive, you must permit the use of Basic Authentication in the Windows Registry. The procedure is documented in KB841215 and differs between Windows XP/Server 2003 and Windows Vista/7. Please follow the Knowledge Base article before proceeding, and follow the Vista instructions if you run Windows 7.

Mapping Drives With the Command Line¶

The following example shows how to map a drive using the command line. To map the drive:

Open a command prompt in Windows.

Enter the following line in the command prompt to map to the computer Z drive:

For example: net use Z: https://example.com/owncloud/remote.php/dav/files/USERNAME/ /user:youruser yourpassword

Though not recommended, you can also mount the ownCloud server using HTTP, leaving the connection unencrypted. If you plan to use HTTP connections on devices while in a public place, we strongly recommend using a VPN tunnel to provide the necessary security.

An alternative command syntax is:

Mapping Drives With Windows Explorer¶

To map a drive using the Microsoft Windows Explorer:

1. Migrate to your computer in Windows Explorer.
2. Right-click on Computer entry and select Map network drive. from the drop-down menu.
3. Choose a local network drive to which you want to map ownCloud.
4. Specify the address to your ownCloud instance, followed by /remote.php/dav/files/USERNAME/.

For SSL protected servers, check Reconnect at logon to ensure that the mapping is persistent upon subsequent reboots. If you want to connect to the ownCloud server as a different user, check Connect using different credentials.

Accessing Files Using Cyberduck¶

Cyberduck is an open source FTP and SFTP, WebDAV, OpenStack Swift, and Amazon S3 browser designed for file transfers on Mac OS X and Windows.

This example uses Cyberduck version 4.2.1.

To use Cyberduck:

1. Specify a server without any leading protocol information. For example:

2. Specify the appropriate port. The port you choose depends on whether or not your ownCloud server supports SSL. Cyberduck requires that you select a different connection type if you plan to use SSL. For example:

443 (for WebDAV (HTTPS/SSL))

3. Use the ‘More Options’ drop-down menu to add the rest of your WebDAV URL into the ‘Path’ field. For example:

Now Cyberduck enables file access to the ownCloud server.

Accessing public shares over WebDAV¶

ownCloud provides the possibility to access public shares over WebDAV.

To access the public share, open:

in a WebDAV client, use the share token as username and the (optional) share password as password.

Known Problems¶

Problem¶

Windows does not connect using HTTPS.

Solution 1¶

The Windows WebDAV Client might not support Server Name Indication (SNI) on encrypted connections. If you encounter an error mounting an SSL-encrypted ownCloud instance, contact your provider about assigning a dedicated IP address for your SSL-based server.

Solution 2¶

The Windows WebDAV Client might not support TSLv1.1 / TSLv1.2 connections. If you have restricted your server config to only provide TLSv1.1 and above the connection to your server might fail. Please refer to the WinHTTP documentation for further information.

Problem¶

You receive the following error message: Error 0x800700DF: The file size exceeds the limit allowed and cannot be saved.

Solution¶

Windows limits the maximum size a file transferred from or to a WebDAV share may have. You can increase the value FileSizeLimitInBytes in HKEY_LOCAL_MacHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters ** by clicking on **Modify.

To increase the limit to the maximum value of 4GB, select Decimal, enter a value of 4294967295, and reboot Windows or restart the WebClient service.

Problem¶

Accessing your files from Microsoft Office via WebDAV fails.

Solution¶

Known problems and their solutions are documented in the KB2123563 article.

Problem¶

Cannot map ownCloud as a WebDAV drive in Windows using self-signed certificate.

Solution¶

1. Go to the your ownCloud instance via your favorite Web browser.
2. Click through until you get to the certificate error in the browser status line.
3. View the cert, then from the Details tab, select Copy to File.
4. Save to the desktop with an arbitrary name, for example myOwnCloud.cer .
5. Start, Run, MMC.
6. File, Add/Remove Snap-In.
7. Select Certificates, Click Add, My User Account, then Finish, then OK.
8. Dig down to Trust Root Certification Authorities, Certificates.
9. Right-Click Certificate, Select All Tasks, Import.
10. Select the Save Cert from the Desktop.
11. Select Place all Certificates in the following Store, Click Browse,
12. Check the Box that says Show Physical Stores, Expand out Trusted Root Certification Authorities, and select Local Computer there, click OK, Complete the Import.
13. Check the list to make sure it shows up. You will probably need to Refresh before you see it. Exit MMC.
14. Open Browser, select Tools, Delete Browsing History.
15. Select all but In Private Filtering Data, complete.
16. Go to Internet Options, Content Tab, Clear SSL State.
17. Close browser, then re-open and test.

Problem¶

You cannot download more than 50 MB or upload large Files when the upload takes longer than 30 minutes using Web Client in Windows 7.

Solution¶

Workarounds are documented in the KB2668751 article.

Accessing Files Using cURL¶

Since WebDAV is an extension of HTTP cURL can be used to script file operations.

To create a folder with the current date as name:

To upload a file error.log into that directory:

To get the properties of files in the root folder:

Свое облако ownCloud

Облачные хранилища и другие сервисы прочно вошли в арсенал повседневных инструментов многих активных пользователей. Они обеспечивают синхронизацию данных, постоянный доступ к ним в любой точке, где есть интернет.

Удаленное резервирование способствует сохранности информации. Читая рекламные страницы-лэндинги дата-центров, размещенных где-нибудь в оставшихся от холодной войны автономных бомбоубежищах, выдерживающих близкий ядерный взрыв, так и подмывает предложить слоган: «Когда в Землю врежется комета, выживут тараканы и ваши данные!»

В то же время в облачных технологиях нет каких-то супернавороченных решений, которые невозможно повторить на своем компьютере. Если, конечно, вынести за скобки их масштабы. Биг дата есть биг дата. Для личного пользования вполне можно обойтись подручными средствами и создать собственное облако, получив несколько приятных бонусов. Сейчас доступны несколько пакетов, предлагающих готовые решения для персональных облаков. Они отличаются нюансами назначения, возможностями, сферой применения. Мы поговорим об универсальном бесплатном пакете ownCloud (owncloud.org). Конечно, он ориентирован на подготовленных пользователей, но разработчики постарались свести к минимуму специальные требования для установки и настройки персонального облака.

Платформа ownCloud развивается двумя линейками: Enterprise, предназначенной для бизнес-решений, и Community, рассчитанной на частных пользователей. ownCloud Community Edition распространяется бесплатно, под лицензией AGPL/GPL, подразумевающей обязательное открытие сообществу сделанных вами модификаций кода. Помимо лицензии ветки отличаются возможностями. Коммерческая версия предлагает больше возможностей по интеграции со сторонними сервисами и платформами, несколько расширенные опции обеспечения безопасности, а также всякие плюшки в духе брендированных мобильных клиентов. Кстати говоря, мобильные клиенты для Community Edition также платные.

Поскольку собственные облака – это достаточно сложные системы, давайте разберемся, из каких элементов состоит ownCloud. Во-первых, это серверная часть, которая и будет обеспечивать основную функциональность будущего сервиса. Для Community Edition предлагается два варианта инсталлятора: полный пакет в архиве для принадлежащего вам сервера, а также веб-инсталлятор для арендуемого вами хостинга. Он написан на PHP, самостоятельно проверяет настройки окружения, скачивает и устанавливает необходимые компоненты. Наконец, это обновления, выполненные отдельно устанавливаемыми пакетами. Кроме того, предлагаются готовые образы виртуальных машин, а также рекомендации по развертыванию ownCloud на Raspberry Pi, Synology NAS и некоторых других специфичных платформах. Для полноценной работы с будущим облаком понадобятся клиенты. Они бесплатны и доступны для платформ Windows, Linux и Mac OS.

На официальном сайте ownCloud развернута демонстрационная версия сервиса, так что пощелкать кнопочками и посмотреть, как она выглядит, можно и не затевая собственную установку. Поскольку это открытая платформа, сообществом разработано немало дополнений к серверу, позволяющих интегрировать его со сторонними приложениями и службами. Они распространяются свободно и устанавливаются отдельно.

Мы будем говорить о первом варианте установки, подразумевающем использование вашего собственного компьютера под управлением Windows. Все предлагаемые пакеты подписаны цифровой подписью, которую можно проверить с помощью PGP – совсем не лишняя мера, если учесть характер будущего использования платформы.

Пару слов о документации. Официальные мануалы доступны только на английском языке. Для работы обязательно понадобится как минимум два документа: Руководства пользователя и администратора. Положа руку на сердце, я не могу назвать их образцом качественного технического писательства. Далее я вкратце последовательно изложу все основные моменты, необходимые для быстрого старта сервера, а также поделюсь собственным опытом и опишу возможные грабли.

Начну с того, что разработчики ownCloud предполагают, что на вашей машине уже установлена и настроена связка из веб-сервера, интерпретатора и СУБД. Развертывание такой платформы – это отдельная и серьезная тема. Задачу облегчает то, что это вполне стандартный для администраторов процесс, многократно описанный в литературе, поэтому сейчас не вижу смысла подробно на нем останавливаться. Если вы хотите упростить себе задачу или не занимались раньше настройкой серверного окружения, рекомендую воспользоваться одним из многочисленных готовых пакетов, устанавливающих и самостоятельно настраивающих эту классическую для веб-разработки связку. Общее название такого класса приложений – WAMP (Windows-Apache-MySQL-PHP). В основном они схожи, можно выбирать то, что вам больше понравится по составу исходных компонентов и дополнительным возможностям системы администрирования. В нашем конкретном случае посоветую только брать пакет с минимальным количеством улучшений и «улучшений» от разработчика. Развертывать рабочий сервер, например, на основе «Денвера» я бы не стал, при всем уважении к этому и другим подобным серьезно доработанным пакетам. Дело в том, что чем меньше кто-то копался в исходных пакетах сервера, тем меньше будет наш риск отхватить каких-нибудь необычных и с трудом отлавливаемых багов при настройке ownCloud. Можно также попробовать поработать со встроенным в некоторые версии Windows веб-сервером MS IIS, вот только установкой и настройкой всех необходимых для работы платформы компонентов придется заниматься самостоятельно. Поэтому далее предполагается, что инсталляция ведется на веб-сервер Apache.

Распаковываем скачанный архив в домашний каталог (DocumentRoot) веб-сервера и запускаем веб-интерфейс установки пакета. Если вы не заморачивались настройкой виртуальных хостов, просто положив каталог ownCloud на сервер, он будет доступен по адресу localhost/owncloud/index.php. Назначение этой страницы – проверка окружения, если не хватает каких-либо расширений, выводится уведомление, также здесь можно задать пароль доступа и выбрать используемую СУБД: sqLite или же MySQL/MariaDB. Если вы создавали базу данных заранее, будьте готовы сообщить системе логин и пароль администратора или другого пользователя СУБД, обладающего правами на правку базы данных. Далее все происходит автоматически. Наше участие понадобится, только когда уже будет доступна панель настроек установленного сервера.

Основные функции ownCloud выполнены в виде приложений-модулей. Некоторые модули, например синхронизации контактов, уже включены в стартовый пакет сервера. В рамках первоначальной настройки стоит определиться с применением HTTPS – если ваш сервер настроен на использование этой технологии, ownCloud может принудительно включать данный режим для всех соединений, что заметно повышает безопасность доступа. Возможно создание отдельных учетных записей для пользователей, которым вы предполагаете дать доступ к облаку. Очень важная настройка находится в разделе «Управление файлами» – это максимальный размер загружаемого файла. По умолчанию предлагается значение 513 Мбайт, его можно изменить по своему вкусу. Важно только помнить об одном обстоятельстве. Барьером увеличения его размера могут стать не только настройки ownCloud, но и настройки серверного окружения. В частности, собственные ограничения на размер файлов присутствуют в интерпретаторе PHP, а также могут встретиться в СУБД. Так что если выставленные вами предельные размеры не работают, первым делом загляните в файлик php.ini и проверьте там значения директив post_max_size и upload_ max_filesize.

Еще одна интересная опция доступна, если вы используете офисные пакеты OpenOffice или LibreOffice, установленные на сервере. В этом случае их можно подключить к ownCloud – документы поддерживаемых форматов можно будет открывать и редактировать напрямую в облаке с помощью соответствующих приложений «офисов». Получается довольно мощная связка, на мой взгляд, при личном использовании мало чем уступающая коммерческим решениям от той же Microsoft. Именно такие возможности превращают простое файловое хранилище с веб-интерфейсом в полноценное облако.

По умолчанию сразу предлагаются папки для хранения офисных документов и фотографий. От обычных каталогов с файлами они отличаются внешним видом шаблона страницы, с генерацией миниатюр. Каталоги, конечно же, можно создавать и самому в нужном количестве.

Для загрузки и скачивания файлов можно применять веб-интерфейс, локальные клиенты ownCloud, стандартные средства операционной системы и сторонние приложения. С веб-интерфейсом мы уже знакомы, там все просто. Локальный Windows-клиент требует минимум настроек – только адрес сервера и логин/пароль доступа. Как и другие подобные клиенты, программа создает папки, в которые сохраняются нужные файлы, они будут автоматически синхронизироваться с сервером. В настройках клиента есть опция ограничения полосы интернет-соединения, которую вы готовы выделить на нужды синхронизации.

Пару слов об альтернативных вариантах подключения. Если использовать стандартные средства работы Windows с WebDAV, рекомендуется подключать облачные ресурсы как отдельный виртуальный диск. В результате работа с облаком внешне ничем не будет отличаться от обращения к обычным сетевым дискам. Подключить диск можно из командной строки, запустив консоль cmd. Синтаксис команды следующий: net use Z: https://URL_сервера/owncloud/ remote.php/webdav /user:логин пароль, где Z: – назначаемая буква виртуального диска, вместо защищенного HTTPS можно указать обычный HTTP, заметно снизив при этом защиту связки «клиент-сервер». Файлы-то в этом случае будут передаваться без использования шифрования.

Можно воспользоваться и визуальным интерфейсом Проводника Windows, но это не так прикольно, ведь всего-то понадобится вызвать контекстное меню для элемента «Этот компьютер», выбрать там опцию «Подключить сетевой диск» и следовать указаниям мастера подключения. Не забудьте только добавить путь /remote.php/webdav к URL сервера.

Серьезнейшим образом расширяет возможности работы с ownCloud использование мобильных приложений. Как уже было сказано, собственный клиент пакета для Android платный и стоит целый один доллар. Однако, поскольку сервер умеет работать с WebDAV, теоретически сгодится любое стороннее приложение, поддерживающее передачу файлов с использованием этой технологии. Их не так уж мало. На практике, конечно же, возможны варианты, которые зависят в том числе от версии Android и сервера ownCloud, поэтому я воздержусь от конкретных рекомендаций и посоветую заглянуть на форум пользователей пакета – там есть соответствующая тема с табличкой и отзывами об опыте использования различных мобильных приложений для синхронизации с ownCloud.

Дополнить возможности ownCloud можно с помощью модулей. Их установка максимально упрощена. Как правило, достаточно выбрать нужный модуль в каталоге на сайте проекта, скачать и распаковать архив. Включаются и отключаются модули на панели управления в веб-интерфейсе ownCloud.

Подведем итоги. ownCloud – вполне достойное и стабильно работающее решение для создания собственного облака. Я его использую с удовольствием и пока не сталкивался с действительно серьезными проблемами. Какой же будет сфера применения собственного облака? Да такой же, как и у арендуемого. С некоторыми особенностями. Свой сервис выгодно развертывать, если вам нужен удаленный доступ к крупным файлам. Ограничения вы выставляете самостоятельно, такого раздолья на арендуемом хостинге не будет. Что еще важнее, вы защищены от любых выбрыков владельцев внешних сервисов. У вас не закончится подписка, вам не будут навязывать дополнительные услуги или ограничивать существующие. Все файлы остаются на ваших машинах, что важно в случае конфиденциальных данных. Сервис получается бесплатным, за исключением затрат на электричество. Недостатки также понятны: сервер желательно держать постоянно включенным, все проблемы настройки и риски сохранности данных несете лично вы. Да и функциональные возможности клиентов лидирующих коммерческих облаков все-таки пока побогаче.