.. include:: images.rst
.. include:: /urls.rst

.. _sw_pureos_tips_nextcloud:

Nextcloud
=========

.. _sw_pureos_tips_nextcloud_overview:

Overview
--------

If you are wondering how to be on the cloud with your Librem device, we recommend `Nextcloud`_, the freedom-respecting online productivity platform that keeps you in control.
Nextcloud allows you to upload, edit, and share documents and files.
It also features calendering and advanced plugins.

.. raw:: html

    <video width="80%" controls>
        <source src="https://videos.puri.sm/promo/nextcloud_setup.mp4" type="video/mp4">
        <source src="https://videos.puri.sm/promo/nextcloud_setup.webm" type="video/webm">
        Your browser does not support HTML video.
    </video>

:download:`Download <https://videos.puri.sm/promo/nextcloud_setup.mp4>`
`Secure and cloud-friendly experience with Librem 14 and Nextcloud`_

.. _sw_pureos_tips_nextcloud_nautilus:

Integration with a file manager (nautilus)
------------------------------------------

There are several options available if you wish to have a copy of your cloud data stored locally on your desktop.
If you use NextCloud Desktop application, you may create, delete and manage share links of your cloud files from within the Files application already installed on your computer, without needing to login within a browser. 

To do this, you must install the Files app plugin ``nautilus-nextcloud``:

#. Open a terminal application and type the command:

   .. code-block:: bash

      sudo apt install nautilus-nextcloud

#. Press **Enter**
#. Type your password and press **Enter** again.
   If you are asked for confirmation, press the **y** key or the key representing "yes" in your system language.

   .. image:: ../img/nautilus/01-install-nautilus-nextcloud.png
      :scale: 50%
      :alt: Installing the Nextcloud extension for Nautilus

If you navigate to your Nextcloud folder or inside it, you will see that the folders have green "check" icon.
That means Nextcloud Desktop client is now integrated with the Files app.

.. image:: ../img/nautilus/02-green-icons.png
   :scale: 50%
   :alt: Nextcloud extension within Nautilus

You will see different icons acording to the state of the file or folder. 

+--------------------------------------------------------+-----------------------------------------------------+--------------------------------------+
| Synced                                                 | Syncing                                             | Shared                               |
+========================================================+=====================================================+======================================+
| .. image:: ../img/nautilus/02-green-icon-on-folder.png | .. image:: ../img/nautilus/05-syncing-on-folder.png | .. image:: ../img/nautilus/share.png |
|    :height: 48px                                       |    :height: 48px                                    |    :height: 48px                     |
|    :width: 48px                                        |    :width: 48px                                     |    :width: 48px                      |
+--------------------------------------------------------+-----------------------------------------------------+--------------------------------------+

Creating a share link of from the Files app
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

 #. Right click the file/folder in question
 #. Select the option "Nextcloud"
 #. Select "Share..."

.. image:: ../img/nautilus/general_selecting.png
   :scale: 50%
   :alt: Right-click context menu

Check the option **enable** and press the |kebab-menu| (kebab menu) icon to edit settings of the share link.

.. image:: ../img/nautilus/enable-settings.png
   :scale: 50%
   :alt: Enable checkbox and kebab button

**From here you can:**

 #. Copy the link
 #. Set expiry date for the link
 #. Set password to access the shared item
 #. Delete the share link
 
**If you are sharing a folder then you can also:**

 #. Set the folder as a upload folder for files
 #. Set the folder and it's contents as read only
 #. Allow uploading to, and editing content in the folder

.. image:: ../img/nautilus/v-01.png
   :scale: 50%
   :alt: Options

**To set password or expiry date:**

 #. Select the respective option
 #. Set the password
 #. Set the date
 #. Press the arrow key to right of the option you want to enable, password or expiry date (press both arrows to enable both).

.. image:: ../img/nautilus/date_and_password.png
   :scale: 50%
   :alt: Date and password

Sharing with other Nextcloud users using the same instance
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

 #. Write the username of the person you want to share with
 #. Press enter 

.. image:: ../img/nautilus/by_user_00.png
   :scale: 50%
   :alt: By user 00

After pressing enter you will see the user avatar in the lower part of the window.

.. image:: ../img/nautilus/by_user_face.png
   :scale: 50%
   :alt: User avatar

Edit the settings of the share by pressing the kebab (3 dots) button.

**If it is a file you can:**

 #. Allow editing
 #. Allow resharing

To delete the share just press the trash button

.. image:: ../img/nautilus/by_user_01.png
   :scale: 50%
   :alt: By user 01

**If it is a folder, select the "Can edit" button to allow the following options:**

 #. Editing
 #. Create a sub-folder
 #. Delete folders
 #. Reshare

To delete the share just press the trash button.
To revoke a permission, uncheck the option in question.

.. image:: ../img/nautilus/by_user_02.png
   :scale: 50%
   :alt: By user 02