add nextcloud docs (#14)

source/manual/how-tos/cloud_backup.rst

@@ -2,9 +2,9 @@
 Configuration Cloud Backup
 ==========================
 
-------------
-Google Drive
-------------
+--------------------------
+Google Drive and Nextcloud
+--------------------------
 
 **Google Drive** is a digital file storage and management service by the
 information technology company Google. Amongst other features, like
@@ -12,6 +12,10 @@ collaborative editing of documents, spreadsheets, and presentations, it
 allows signed up users with an account to store and share files in the
 digital cloud.
 
+**Nextcloud** is also an online storage but in contrast to Google Drive
+it is intended for self hosting. You can download it freely from their
+`website <https://nextcloud.com/>`__ and install it on your webserver.
+
 The OPNsense configuration can be stored as a backup file in XML format,
 to your PC on an USB stick or remotely in the digital Google Drive
 cloud.
@@ -22,7 +26,7 @@ Free online storage
 
 Because Google officially offers a free storage of 15 GB and nearly
 unlimited traffic, a remote backup of an OPNsense configuration file is
-free of charge, the only thing you need is an account at google
+free of charge, the only thing you need is an account at Google
 (`Google Drive Signup <https://accounts.google.com/signup?hl=en>`__) .
 
 --------
@@ -33,13 +37,18 @@ An application programming interfaces (API) for Google Drive was
 released in 2013. This API empowers third-party developers to easily
 write apps for Google Drive.
 
+Nextcloud is using WebDAV which works without a special library
+so data can be sent directly to the server without a special client
+library (for example, a file upload is just a HTTP PUT call).
+
 -------------
 Remote backup
 -------------
 In OPNsense\ :sup:`1` you can **backup** your configuration directly and
-automatically to **Google Drive**, using the new backup feature. Every
-backup will be encrypted with the same algorithm used in the manual
-backup so it's quite easy to restore to a new installed machine.
+automatically to **Google Drive** and **Nextcloud**, using the new backup
+feature. Every backup to **Google Drive** will be encrypted with the same
+algorithm used in the manual backup so it's quite easy to restore to a new
+installed machine.
 
 After set-up, the backup feature will do first store of the OPNsense
 config file and subsequently a daily new backup of changed config
@@ -107,6 +116,59 @@ The moment the feature is enabled, it will do a daily compare of the
 last file in backup and the current configuration and creates a new
 backup when something has changed.
 
+
+-------------------------
+Setup Nextcloud API usage
+-------------------------
+
+1. Step Create a new user
+=========================
+
+Click on the user icon top right and click "Users".
+In the new page, enter an username and a password into the boxes and click
+create to create a new user.
+
+
+2. Step Create an Access Token
+==============================
+
+Close the modal dialog and remove the default files.
+Then open the Settings menu (also in the menu top right).
+Switch to security and generate a App password.
+
+.. image:: images/nextcloud_create_token.png
+
+Copy and store the generated password.
+
+3. Step Connect OPNsense with Nextcloud
+=======================================
+
+.. image:: images/nextcloud_config.png
+
+Scroll to the Nextcloud Section in System -> Config -> Backup and enter the
+following values:
+
+================ ======================================================================
+Enable           checked
+URL              Base URL of your Nextcloud installation like https://cloud.example.com
+User             your choosen username
+Password         paste your app password from step 2
+Backup Directory a name consisting of alphanumeric characters (keep default)
+================ ======================================================================
+
+
+4. Step Verify the Configuration Upload
+=======================================
+
+When everything worked, you will see the newly created directory after saving
+the settings:
+
+.. image:: images/nextcloud_directory.png
+
+If you open it, you will see at lease a single backed up configuration file:
+
+.. image:: images/nextcloud_backups.png
+
 .. rubric:: References
    :name: references