Nextcloud: Difference between revisions

From Alliance Doc
Jump to navigation Jump to search
No edit summary
No edit summary
 
(47 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{draft}}
<languages />
<translate>


=Introduction=
<!--T:2-->
We provide Nextcloud, a Dropbox-like cloud storage service, for all Alliance users. You can use your Alliance username and password to log in to the [https://nextcloud.computecanada.ca/ Nextcloud server]. A complete [https://docs.nextcloud.com/server/19/Nextcloud_User_Manual.pdf Nextcloud user manual] is available from the [https://docs.nextcloud.com/ official Nextcloud documentation]. A manual is also available as a PDF document under your account once you connect. All data transfers between local devices and Alliance's Nextcloud are encrypted.


We now provide nextCloud, a Dropbox-like cloud storage service, for all Compute Canada users. You can use your Compute Canada username and password to login to the [https://nextcloud.computecanada.ca/ nextCloud server]. A complete nextCloud user [https://docs.nextcloud.com/server/19/Nextcloud_User_Manual.pdf manual] is available from [https://docs.nextcloud.com/ docs.nextcloud.com]. Another manual is available as PDF document under your account once you connect. All data transfers between local devices and Compute Canada's nextCloud are encrypted.
<!--T:3-->
The Nextcloud service is aimed at users with relatively small datasets (up to 100 GB). For anything larger, we recommend using the [[Globus/en|Globus]] service.


The nextCloud service is aimed at users with relatively small datasets (up to a few hundred GB). For anything larger the Globus service is much to be preferred.
<!--T:4-->
If you are not familiar with the concept of Nextcloud, you may try the [https://try.nextcloud.com/ demo on the Nextcloud website].


If you are not familiar with the concept of nextCloud, you may try the online [https://try.nextcloud.com/ demo] on nextCloud website.
<!--T:8-->
We recommend taking this opportunity to take a look at your data and do some cleanup: remove data you no longer need, check with whom you share your data, etc.


=Migrating from ownCloud to nextCloud=
==Alliance Nextcloud service description== <!--T:9-->


Since the [https://www.westgrid.ca/resources_services/data_storage/cloud_storage legacy WestGrid owncloud] service will be decommissioned (in the near future) it will be necessary for ownCloud users to move their data to nextCloud, a service offered by Compute Canada. Note that the two services are installed in separate instances.  
<!--T:10-->
* <b>Server URL:</b> https://nextcloud.computecanada.ca
* <b>Server Location:</b> Simon Fraser University, Burnaby, BC
* <b>Fixed Quota:</b> 100 GB per user
* <b>Backup Policy:</b> Daily backup without offsite copy
* <b>Access Methods:</b> Web interface, Nextcloud Desktop Sync Client, Nextcloud mobile apps, and any WebDAV client
* <b>Documentation:</b> [https://docs.nextcloud.com/server/19/Nextcloud_User_Manual.pdf PDF] and [https://docs.nextcloud.com/ online]


* An easy way to proceed is to start over by uploading your data from ownCloud to your local machine (Desktop or laptop) and start uploading them via web interface or any other tool as discussed below.
==Using the Nextcloud web interface== <!--T:11-->
* If you shared already files or folders with other WestGrid users, you will have to share them again.
* Take this opportunity to have a look to your data and do some clean-up: remove data you no longer need, check with whom you share your data, ... etc.


=Compute Canada nextCloud service description=
<!--T:12-->
To use the web interface, log in to Alliance [https://nextcloud.computecanada.ca Nextcloud] from a web browser using your Alliance username and password. You can upload and download files between Nextcloud and your mobile device or computer, edit files, and share files with other Alliance users. For more information, see the [https://docs.nextcloud.com/server/19/Nextcloud_User_Manual.pdf Nextcloud user manual].


* '''Server URL:''' https://nextcloud.computecanada.ca
==Using Nextcloud Desktop Synchronization Client and mobile apps== <!--T:13-->
* '''Server Location:''' Simon Fraser University, Burnaby, BC
* '''Default Quota:''' 100 GB per user.
* '''Backup Policy:''' Daily backup without offsite copy.
* '''Access Methods:''' Web interface, nextCloud Desktop Sync Clients, nextCloud Mobile Apps, and any WebDAV clients
* '''Documentation:''' [https://docs.nextcloud.com/server/19/Nextcloud_User_Manual.pdf PDF] and [https://docs.nextcloud.com/ online].


=Using nextCloud web interface=
<!--T:14-->
You can [https://nextcloud.com/install/ download the Nextcloud Desktop Sync Client or Nextcloud mobile apps] to synchronize data from your computer or your mobile device respectively. Once installed, the software will "sync" everything between your Nextcloud folder and your local folder. It may take some time to synchronize all data. You can make changes to files locally and they will be updated in Nextcloud automatically.


To use the web interface, login to Compute Canada [https://nextcloud.computecanada.ca nextCloud] from a web browser using your Compute Canada username and password. You can upload and download files between your desktop (or laptop) and nextCloud, edit files, and share files with other Compute Canada users. For more information, please refer to the nextCloud user [https://docs.nextcloud.com/server/19/Nextcloud_User_Manual.pdf manual].
==Using WebDAV clients== <!--T:15-->


=Using nextCloud Desktop Sync Clients and Mobile Apps=
<!--T:16-->
In general, you can use any WebDAV clients to "mount" a Nextcloud folder to your computer using the following WebDAV URL: https://nextcloud.computecanada.ca/remote.php/webdav/


These clients, once installed on your devices, will "sync" everything between your nextCloud folder and your desktop/mobile device folder. Please note, it may take some time to sync all data. You can make changes to files locally on your device and they will be updated in nexCloud automatically. You can download the nextCloud Desktop Sync Clients and nextCloud Mobile Apps for iOS devices and Android devices from https://nextcloud.com/install/
<!--T:17-->
Once mounted, you can drag and drop files between the WebDAV drive and your local computer.


=Using WebDAV clients=
<!--T:18-->
<b>Mac OSX: </b>Select Go -> Connect to the Server, enter the WebDAV URL for the Server Address, and click Connect. You will be asked for your username and password to log in. After authentication, you will see a WebDAV drive on your Mac.


In general, you can use any WebDAV clients to "mount" a nextCloud folder to your desktop using the following WebDAV URL: https://nextcloud.computecanada.ca/remote.php/webdav/  
<!--T:19-->
<b>Windows: </b>Use the "Map Network Drive ..." option, select a drive letter, then use WebDAV URL https://nextcloud.computecanada.ca/remote.php/webdav/ in the Folder field.


Once mounted, you can drag and drop files between the WebDAV drive and your local desktop.
<!--T:21-->
You may also consider using Cyberduck or other clients instead. [https://cyberduck.io/ Cyberduck] is available for OSX and Windows.


'''Mac OSX:''' Select Go -> Connect to the Server, enter the WebDAV URL for the Server Address, and click Connect. You will be asked for your username and password to login. After authentication, you will see a WebDAV drive on your desktop.
<!--T:22-->
<b>Linux:</b> There are many WebDAV applications available for Linux. Consult the [https://docs.nextcloud.com/server/19/Nextcloud_User_Manual.pdf Nextcloud user manual] for recommendations.


'''Windows:'''
===Detail: WebDAV vs Synchronization Client=== <!--T:23-->


Use "Map Network Drive ..." option, select a drive letter, then use WebDAV URL https://nextcloud.computecanada.ca/remote.php/webdav/ in the Folder field.
<!--T:24-->
The WebDAV clients mount your Nextcloud storage on your computer. Files are not copied; for example, when you edit a file, you edit the original file on the Alliance Nextcloud system at Simon Fraser University.


You may also consider using Cyberduck or other clients instead. Cyberduck is available for OSX and Windows.
<!--T:25-->
When you connect with a Synchronization client, the first thing the client does is synchronize your files stored in the Alliance Nextcloud system with a copy of those files on your own computer. All files that are different get downloaded to your own client. When files are changed, they are re-copied to all the synchronized systems to ensure that the files are the same everywhere.  The synchronization copies can take a lot of time when you (and/or your collaborators) change files frequently. The advantage is that you can work on the files offline, i.e., when you do not have network connectivity. They will be synchronized when network connectivity is re-established.


'''Linux:''' There are many WebDAV applications available for Linux, please consult the nextCloud user manual for recommendations.
==Using UNIX command line tools== <!--T:26-->


==Detail: WebDAV vs Synchronization Clients==
<!--T:27-->
You can use any available WebDAV command line clients, like [https://curl.haxx.se/ curl] and [http://www.webdav.org/cadaver/ cadaver], to copy files between your Unix computer and Nextcloud. Command line tools are useful when you want to copy data between a remote server you log in to and Nextcloud.


The WebDAV clients mount your nextCloud storage on your desktop.  Files are not copied, e.g., when you edit a file you edit the original file on the Compute Canada nextCloud system at Simon Fraser University.
<!--T:28-->
curl is usually installed on Mac OSX and Linux systems and can be used to upload and download files using a URL.


When you connect with a Synchronization client the first thing these clients do is to synchronize your files stored in the Compute Canada nextCloud system with a copy of those files on your own desktop or laptop. All files that are different get downloaded to your own client. When files are changed they are re-copied to all the synchronized systems to ensure that the files are the same everywhere.  The synchronization copies can take a lot of time when you (and/or your collaborators) change files frequently. The advantage is that you can work on the files offline, i.e., when you do not have network connectivity.  They will be synchronized when network connectivity is re-established.
===Upload a file using <code>curl</code>=== <!--T:29-->


=Using UNIX Command Line Tools=
<!--T:30-->
{{Command|curl -k -u <username> -T <filename> https://nextcloud.computecanada.ca/remote.php/webdav/}}
 
===Download a file using <code>curl</code>=== <!--T:31-->
 
<!--T:32-->
{{Command|curl -k -u <username> https://nextcloud.computecanada.ca/remote.php/webdav/<filename> -o <filename>}}
 
===Upload and download files using <code>rclone</code>=== <!--T:35-->
 
<!--T:36-->
Unlike [https://curl.haxx.se/ curl], [https://rclone.org rclone] lets you create a configuration once for each remote device and use it repeatedly without having to enter the service details and your password every time. The password will be stored encrypted in <i>~/.config/rclone/rclone.conf</i> on the computer or server where the <code>rclone</code> command is used.
 
<!--T:37-->
First, [https://rclone.org/install/ install rclone on your computer if it has a Unix-like environment].
 
<!--T:38-->
If used from our clusters, please note that it is no necessary to install rclone as it is already available:
 
<!--T:39-->
<pre>
$ [name@server ~] $ which rclone
$ /cvmfs/soft.computecanada.ca/gentoo/2023/x86-64-v3/usr/bin/rclone
</pre>
 
<!--T:40-->
Next, configure a remote storage device profile with


You can also use any available WebDAV command line clients, like [https://curl.haxx.se/ curl] and [http://www.webdav.org/cadaver/ cadaver], to copy files between your host and nextCloud. Command line tools are useful when you copy data between a remote host you login to and nextCloud.
<!--T:41-->
<pre>
$ rclone config
</pre>


cURL is usually installed on Mac OSX and Linux systems and can be used to upload and download files using an URL.
<!--T:42-->
You now have the option to edit an existing remote device, create a new remote device, delete a remote device, and so on. Let's say we want to create a new remote serice profile called <i>nextcloud</i>:


==Upload a file using curl:==
<!--T:43-->
<pre>
choose "n"  for "New remote"
Enter name for new remote --> nextcloud
Type of storage to configure --> 52 / WebDAV
URL of http host to connect to --> https://nextcloud.computecanada.ca/remote.php/dav/files/<your CCDB username>
Name of the WebDAV site/service/software you are using --> 2 / Nextcloud
User name --> <your CCDB username>
choose "y" for "Option pass"
Password --> <your CCDB password>
Leave "Option bearer_token" empty
choose "no" for "Edit advanced config"
choose "yes" for "Keep this 'nextcloud' remote"
choose "q" to quit config
</pre>


{{Command|curl -k -u <username> -T <filename> https://nextcloud.computecanada.ca/remote.php/webdav/}}
<!--T:44-->
You should now be able to see your new remote service profile in the list of configured ones with
 
<!--T:45-->
$ rclone listremotes
 
<!--T:46-->
You can probe available disk space with
 
<!--T:47-->
$ rclone about nextcloud:
 
<!--T:48-->
To upload a file, run
 
<!--T:49-->
$ rclone copy /path/to/local/file nextcloud:remote/path
 
<!--T:50-->
To download a file, run


==Download a file using curl==
<!--T:51-->
$ rclone copy nextcloud:remote/path/file .


{{Command|curl -k -u <username> https://nextcloud.computecanada.ca/remote.php/webdav/<filename> -o <filename>}}
==Sharing files using Nextcloud== <!--T:33-->


=Sharing Files using nextCloud=
<!--T:34-->
When you select a file or directory to share, type the user’s first name, last name, or username and the list of matched users registered in CCDB will be displayed in “Firstname Lastname (username)” format. Please review the name carefully as some are very similar; in doubt, enter the username which is unique. You can also share files with a group using their CCDB group name (default, RPP, RRG, or other shared groups).
To share a file with people who don’t have an Alliance account, use the <i>Share link</i> option and  provide their email address. Nextcloud will send an email notification with a link to access the file.


To make it easier for sharing among Compute Canada users, we made a change in the nextCloud installation so that both a user's username and their full name are displayed in the web browser. The format is "Firstname Lastname (username)".
</translate>

Latest revision as of 15:50, 12 June 2024

Other languages:

We provide Nextcloud, a Dropbox-like cloud storage service, for all Alliance users. You can use your Alliance username and password to log in to the Nextcloud server. A complete Nextcloud user manual is available from the official Nextcloud documentation. A manual is also available as a PDF document under your account once you connect. All data transfers between local devices and Alliance's Nextcloud are encrypted.

The Nextcloud service is aimed at users with relatively small datasets (up to 100 GB). For anything larger, we recommend using the Globus service.

If you are not familiar with the concept of Nextcloud, you may try the demo on the Nextcloud website.

We recommend taking this opportunity to take a look at your data and do some cleanup: remove data you no longer need, check with whom you share your data, etc.

Alliance Nextcloud service description[edit]

  • Server URL: https://nextcloud.computecanada.ca
  • Server Location: Simon Fraser University, Burnaby, BC
  • Fixed Quota: 100 GB per user
  • Backup Policy: Daily backup without offsite copy
  • Access Methods: Web interface, Nextcloud Desktop Sync Client, Nextcloud mobile apps, and any WebDAV client
  • Documentation: PDF and online

Using the Nextcloud web interface[edit]

To use the web interface, log in to Alliance Nextcloud from a web browser using your Alliance username and password. You can upload and download files between Nextcloud and your mobile device or computer, edit files, and share files with other Alliance users. For more information, see the Nextcloud user manual.

Using Nextcloud Desktop Synchronization Client and mobile apps[edit]

You can download the Nextcloud Desktop Sync Client or Nextcloud mobile apps to synchronize data from your computer or your mobile device respectively. Once installed, the software will "sync" everything between your Nextcloud folder and your local folder. It may take some time to synchronize all data. You can make changes to files locally and they will be updated in Nextcloud automatically.

Using WebDAV clients[edit]

In general, you can use any WebDAV clients to "mount" a Nextcloud folder to your computer using the following WebDAV URL: https://nextcloud.computecanada.ca/remote.php/webdav/

Once mounted, you can drag and drop files between the WebDAV drive and your local computer.

Mac OSX: Select Go -> Connect to the Server, enter the WebDAV URL for the Server Address, and click Connect. You will be asked for your username and password to log in. After authentication, you will see a WebDAV drive on your Mac.

Windows: Use the "Map Network Drive ..." option, select a drive letter, then use WebDAV URL https://nextcloud.computecanada.ca/remote.php/webdav/ in the Folder field.

You may also consider using Cyberduck or other clients instead. Cyberduck is available for OSX and Windows.

Linux: There are many WebDAV applications available for Linux. Consult the Nextcloud user manual for recommendations.

Detail: WebDAV vs Synchronization Client[edit]

The WebDAV clients mount your Nextcloud storage on your computer. Files are not copied; for example, when you edit a file, you edit the original file on the Alliance Nextcloud system at Simon Fraser University.

When you connect with a Synchronization client, the first thing the client does is synchronize your files stored in the Alliance Nextcloud system with a copy of those files on your own computer. All files that are different get downloaded to your own client. When files are changed, they are re-copied to all the synchronized systems to ensure that the files are the same everywhere. The synchronization copies can take a lot of time when you (and/or your collaborators) change files frequently. The advantage is that you can work on the files offline, i.e., when you do not have network connectivity. They will be synchronized when network connectivity is re-established.

Using UNIX command line tools[edit]

You can use any available WebDAV command line clients, like curl and cadaver, to copy files between your Unix computer and Nextcloud. Command line tools are useful when you want to copy data between a remote server you log in to and Nextcloud.

curl is usually installed on Mac OSX and Linux systems and can be used to upload and download files using a URL.

Upload a file using curl[edit]

Question.png
[name@server ~]$ curl -k -u <username> -T <filename> https://nextcloud.computecanada.ca/remote.php/webdav/

Download a file using curl[edit]

Question.png
[name@server ~]$ curl -k -u <username> https://nextcloud.computecanada.ca/remote.php/webdav/<filename> -o <filename>

Upload and download files using rclone[edit]

Unlike curl, rclone lets you create a configuration once for each remote device and use it repeatedly without having to enter the service details and your password every time. The password will be stored encrypted in ~/.config/rclone/rclone.conf on the computer or server where the rclone command is used.

First, install rclone on your computer if it has a Unix-like environment.

If used from our clusters, please note that it is no necessary to install rclone as it is already available:

$ [name@server ~] $ which rclone
$ /cvmfs/soft.computecanada.ca/gentoo/2023/x86-64-v3/usr/bin/rclone

Next, configure a remote storage device profile with

$ rclone config

You now have the option to edit an existing remote device, create a new remote device, delete a remote device, and so on. Let's say we want to create a new remote serice profile called nextcloud:

choose "n"  for "New remote"
Enter name for new remote --> nextcloud
Type of storage to configure --> 52 / WebDAV
URL of http host to connect to --> https://nextcloud.computecanada.ca/remote.php/dav/files/<your CCDB username>
Name of the WebDAV site/service/software you are using --> 2 / Nextcloud
User name --> <your CCDB username>
choose "y" for "Option pass"
Password --> <your CCDB password>
Leave "Option bearer_token" empty
choose "no" for "Edit advanced config"
choose "yes" for "Keep this 'nextcloud' remote"
choose "q" to quit config

You should now be able to see your new remote service profile in the list of configured ones with

$ rclone listremotes

You can probe available disk space with

$ rclone about nextcloud:

To upload a file, run

$ rclone copy /path/to/local/file nextcloud:remote/path

To download a file, run

$ rclone copy nextcloud:remote/path/file .

Sharing files using Nextcloud[edit]

When you select a file or directory to share, type the user’s first name, last name, or username and the list of matched users registered in CCDB will be displayed in “Firstname Lastname (username)” format. Please review the name carefully as some are very similar; in doubt, enter the username which is unique. You can also share files with a group using their CCDB group name (default, RPP, RRG, or other shared groups). To share a file with people who don’t have an Alliance account, use the Share link option and provide their email address. Nextcloud will send an email notification with a link to access the file.