installing.rst 2.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960
  1. =============================================
  2. Installing the Desktop Synchronization Client
  3. =============================================
  4. You can download the latest version of the ownCloud Desktop Synchronization
  5. Client from the `ownCloud download page <https://owncloud.org/install/>`_.
  6. There are clients for Linux, Mac OS X, and Microsoft Windows.
  7. Installation on Mac OS X and Windows is the same as for any software
  8. application: download the program and then double-click it to launch the
  9. installation, and then follow the installation wizard. After it is installed and
  10. configured the sync client will automatically keep itself updated; see
  11. :doc:`autoupdate` for more information.
  12. Linux users must follow the instructions on the download page to add the
  13. appropriate repository for their Linux distribution, install the signing key,
  14. and then use their package managers to install the desktop sync client. Linux
  15. users will also update their sync clients via package manager, and the client
  16. will display a notification when an update is available.
  17. Linux users must also have a password manager enabled, such as GNOME Keyring or
  18. KWallet, so that the sync client can login automatically.
  19. You will also find links to source code archives and older versions on the
  20. download page.
  21. Installation Wizard
  22. -------------------
  23. The installation wizard takes you step-by-step through configuration options and
  24. account setup. First you need to enter the URL of your ownCloud server.
  25. .. image:: images/client-1.png
  26. :alt: form for entering ownCloud server URL
  27. Enter your ownCloud login on the next screen.
  28. .. image:: images/client-2.png
  29. :alt: form for entering your ownCloud login
  30. On the Local Folder Option screen you may sync
  31. all of your files on the ownCloud server, or select individual folders. The
  32. default local sync folder is ``ownCloud``, in your home directory. You may
  33. change this as well.
  34. .. image:: images/client-3.png
  35. :alt: Select which remote folders to sync, and which local folder to store
  36. them in.
  37. When you have completed selecting your sync folders, click the Connect button
  38. at the bottom right. The client will attempt to connect to your ownCloud
  39. server, and when it is successful you'll see two buttons: one to connect to
  40. your ownCloud Web GUI, and one to open your local folder. It will also start
  41. synchronizing your files.
  42. .. image:: images/client-4.png
  43. :alt: A successful server connection, showing a button to connect to your
  44. Web GUI, and one to open your local ownCloud folder
  45. Click the Finish button, and you're all done.