====== Nextcloud ======
[[https://nextcloud.com|Nextcloud]] is a file hosting service like DropBox or Sync that can be self-hosted on a personal server.  Through the use of plugins, it can also be used to share calendars, contacts, etc.  However, for us now, we focus on file sharing only.

Normally, each user has their own account and can store files in a folder that can be synchronized across any number of devices.  Specific files and folders can also be shared with other users on the same Nextcloud instance.

However, the aim here is <fc #ff0000>not</fc> to provide individual cloud hosting.  It is simply to allow easy file sharing with the group.  So one account was created to be shared by all.  On the open internet, this might not be a good idea, but since the service is only accessible to a small group through AREDN, it is the simplest setup.


===== Usage and House Rules =====
One of the obvious advantages of this system is the ability to very easily share files with everyone on the network.
  * Everyone should start by creating a folder with their callsign for the files they "own".
  * Other "shared" folders can be created as needed for other projects, events, etc.

And the obvious:
<WRAP center round important 80%>
  * Don't use this service for anything illegal.
  * This service can be terminated at anytime without warning.
</WRAP>


===== Browser Use =====
To use Nextcloud from the browser:
  * Navigate to: [[aredn>http://va7fi-linux.local.mesh/nextcloud]]
  * Login ([[aredn>http://va7fi-linux.local.mesh/wiki/services/nextcloud/login|credentials]])
  * Click on the folder icon on the top left corner:
{{ web1.png }}
  * Create a folder with your callsign
  * Save files that others will have full access to.

Note that this way of using Nextcloud only works if both the server and client are online.


===== Desktop Sync Client Use =====
A much more convenient way to use Nextcloud is to install a sync client on your computer that will automatically synchronize all Nextcloud files to a folder of your choosing.

It means that you'll have local copies of all the Nextcloud files on your computer even during a network outage.  And should this happen, the new files will be synchronized once the connection is reestablished.  Because of that, <wrap important>you'll need at least 20 GB of free space</wrap> since that's how much space could potentially be saved on Nextcloud.((Currently, the data is saved on a 64 GB SD card, so the quota could be increased in the future if necessary.))

Here's how to setup the client app:
  * Create a folder somewhere that will be synch'ed to Nextcloud.  I called mine ''NextcloudAREDN'' and I put it on my computer's SD card, but you can call yours something different and it can be located anywhere.
  * Download and install the [[https://nextcloud.com/install/#install-clients|client app]] for Windows, MacOS, Linux, Android or iOS.
  * Launch the client app and click ''Log in to your Nextcloud''
{{ client1.png?500 }}
  * Add the server address: [[aredn>http://va7fi-linux.local.mesh/nextcloud]]
{{ client2.png?500 }}
  * Login to the browser window will open.([[aredn>http://va7fi-linux.local.mesh/wiki/services/nextcloud/login|credentials]])((Accessible only through the West Coast AREDN))
  * Setup the local folder options:
{{ client3.png?500 }}
  * Wait for the files to synchronize and you can begin.
  * Closing the client window will simply minimize it to the system tray: {{client4.png}}

/*
===== Server Install =====
<WRAP center round important 15em>
Under Construction
</WRAP>

In the examples below, my username is ''aredn''.  Make sure you use yours, and also change the directories to match your installation.

  * Add execute permission to all folders leading to ''/media/aredn/SDcard/nextcloud''<code bash>
sudo chmod o+x /media
sudo chmod o+x /media/aredn
sudo chmod o+x /media/aredn/SDcard
sudo chmod o+x /media/aredn/SDcard/nextcloud
</code>

  * Move ''config'' and ''data'' folders to SD card:<code bash>
sudo mv /home/aredn/html/nextcloud/config /media/aredn/SDcard/nextcloud/
sudo mv /home/aredn/html/nextcloud/data /media/aredn/SDcard/nextcloud/
</code>

  * Create symlinks of folders back to main nextcloud folder:<code bash>
sudo -u www-data ln -s /media/aredn/SD64/nextcloud/config /home/aredn/html/nextcloud/
sudo -u www-data ln -s /media/aredn/SD64/nextcloud/data /home/aredn/html/nextcloud/
</code>


===== References =====
  * [[https://doc.owncloud.com/server/next/admin_manual/maintenance/manually-moving-data-folders.html]]
  * [[https://samhobbs.co.uk/2013/10/install-owncloud-on-your-raspberry-pi?page=3]]
  * [[https://stackoverflow.com/questions/7381371/apache-wont-follow-symlinks-403-forbidden]]
  * [[http://192.168.1.100/wiki/linuxmintconfig#owncloud]]

*/