Nextcloud
*********

.. highlight:: bash

.. tip:: I started by creating a server with 1GB of RAM.
         We were getting out of memory errors, so I upgraded to 2GB and all
         seems fine for now.

I used these instructions:
`How to Install Nextcloud with Nginx and Lets Encrypt on Ubuntu 20.04 LTS`_

To create these Salt states for install:
https://gitlab.com/kb/salt/-/merge_requests/29

To download::

  wget -q https://download.nextcloud.com/server/releases/latest.zip
  cd ~/repo/project/nextcloud.hatherleigh.info/
  unzip -qq latest.zip
  # create the 'live' folder
  mv nextcloud live
  # tidy up
  mv latest.zip ~/repo/temp/

Use ``fabric`` to create the database::

  fab create-db nextcloud.hatherleigh.info

Import
======

Contacts
--------

Export from Google in ``vcf`` format, *vCard (for iOS Contacts)*.

Google Drive
------------

From `Adding files to Nextcloud using the command line`_::

  # log in as yourself (e.g. ``pat``)
  mkdir /home/web/repo/project/nextcloud.hatherleigh.info/live/data/pat/files/yb

.. tip:: ``yb`` is the folder where you want to put the files
         (e.g. short version of your company name).

https://rclone.org/

.. tip:: I haven't done this yet, but it would be far better to download onto
         the Nextcloud server (to save upload bandwidth).

Download and install ``rclone``::

  curl https://rclone.org/install.sh | sudo bash

Configure::

  rclone config

.. tip:: Use a simple name for your drive e.g. ``pk-drive``.

.. tip:: Choose *Read-only access to file metadata and file contents*.

Sync::

  rclone sync -P pk-drive:/ /home/web/repo/project/nextcloud.hatherleigh.info/live/data/pat/files/yb/

  # to download in LibreOffice format
  rclone sync -P --drive-export-formats ods,odt,odp pk-drive:/ .

.. warning:: Think carefully about the download format.  Nextcloud says,
             *You can even collaborate with others on ODT and Markdown files!*
             It looks as if Collabora Online and ONLYOFFICE are only free for
             personal use,
             https://nextcloud.com/onlyoffice/
             https://nextcloud.com/collaboraonline/
             Perhaps we collaborate using Markdown only!

Scan (scan for new files and update the file cache)::

  sudo -u www-data php /home/web/repo/project/nextcloud.hatherleigh.infoo/live/occ files:scan --path="pat/files/kb/"

.. tip:: ``pat`` is the Nextcloud user name.


.. _`Adding files to Nextcloud using the command line`: https://medium.com/code-enigma/adding-files-to-nextcloud-using-the-command-line-9fe0074b843a
.. _`How to Install Nextcloud with Nginx and Lets Encrypt on Ubuntu 20.04 LTS`: https://www.howtoforge.com/tutorial/ubuntu-nginx-nextcloud/