Nextcloud: Difference between revisions
No edit summary |
No edit summary |
||
(19 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
<languages /> | <languages /> | ||
<translate> | <translate> | ||
<!--T:2--> | <!--T:2--> | ||
We | 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. | ||
<!--T:3--> | <!--T:3--> | ||
The Nextcloud service is aimed at users with relatively small datasets (up to 100 GB). For anything larger, the [[Globus/en|Globus]] service | 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. | ||
<!--T:4--> | <!--T:4--> | ||
If you are not familiar with the concept of Nextcloud, you may try the | If you are not familiar with the concept of Nextcloud, you may try the [https://try.nextcloud.com/ demo on the Nextcloud website]. | ||
<!--T:8--> | <!--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. | 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= <!--T:9--> | ==Alliance Nextcloud service description== <!--T:9--> | ||
<!--T:10--> | <!--T:10--> | ||
Line 25: | Line 24: | ||
* <b>Documentation:</b> [https://docs.nextcloud.com/server/19/Nextcloud_User_Manual.pdf PDF] and [https://docs.nextcloud.com/ online] | * <b>Documentation:</b> [https://docs.nextcloud.com/server/19/Nextcloud_User_Manual.pdf PDF] and [https://docs.nextcloud.com/ online] | ||
=Using the Nextcloud web interface= <!--T:11--> | ==Using the Nextcloud web interface== <!--T:11--> | ||
<!--T:12--> | <!--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 your | 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]. | ||
=Using Nextcloud Desktop Synchronization Client and mobile apps= <!--T:13--> | ==Using Nextcloud Desktop Synchronization Client and mobile apps== <!--T:13--> | ||
<!--T:14--> | <!--T:14--> | ||
Once installed | 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. | ||
=Using WebDAV clients= <!--T:15--> | ==Using WebDAV clients== <!--T:15--> | ||
<!--T:16--> | <!--T:16--> | ||
In general, you can use any WebDAV clients to "mount" a Nextcloud folder to your | 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/ | ||
<!--T:17--> | <!--T:17--> | ||
Once mounted, you can drag and drop files between the WebDAV drive and your local | Once mounted, you can drag and drop files between the WebDAV drive and your local computer. | ||
<!--T:18--> | <!--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 | <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. | ||
<!--T:19--> | <!--T:19--> | ||
Line 53: | Line 52: | ||
<!--T:22--> | <!--T:22--> | ||
<b>Linux:</b> There are many WebDAV applications available for Linux | <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. | ||
==Detail: WebDAV vs Synchronization Client== <!--T:23--> | ===Detail: WebDAV vs Synchronization Client=== <!--T:23--> | ||
<!--T:24--> | <!--T:24--> | ||
The WebDAV clients mount your Nextcloud storage on your | 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. | ||
<!--T:25--> | <!--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 | 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= <!--T:26--> | ==Using UNIX command line tools== <!--T:26--> | ||
<!--T:27--> | <!--T:27--> | ||
You can | 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. | ||
<!--T:28--> | <!--T:28--> | ||
curl is usually installed on Mac OSX and Linux systems and can be used to upload and download files using | 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 <code>curl</code>== <!--T:29--> | ===Upload a file using <code>curl</code>=== <!--T:29--> | ||
<!--T:30--> | <!--T:30--> | ||
{{Command|curl -k -u <username> -T <filename> https://nextcloud.computecanada.ca/remote.php/webdav/}} | {{Command|curl -k -u <username> -T <filename> https://nextcloud.computecanada.ca/remote.php/webdav/}} | ||
==Download a file using <code>curl</code>== <!--T:31--> | ===Download a file using <code>curl</code>=== <!--T:31--> | ||
<!--T:32--> | <!--T:32--> | ||
{{Command|curl -k -u <username> https://nextcloud.computecanada.ca/remote.php/webdav/<filename> -o <filename>}} | {{Command|curl -k -u <username> https://nextcloud.computecanada.ca/remote.php/webdav/<filename> -o <filename>}} | ||
==Upload and download files using <code>rclone</code>== | ===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. | |||
First, | <!--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 | |||
<!--T:41--> | |||
<pre> | |||
$ rclone config | |||
</pre> | |||
<!--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>: | |||
<!--T:43--> | |||
<pre> | <pre> | ||
choose "n" for "New remote" | choose "n" for "New remote" | ||
Line 108: | Line 124: | ||
</pre> | </pre> | ||
<!--T:44--> | |||
You should now be able to see your new remote service profile in the list of configured ones with | |||
$ rclone listremotes | <!--T:45--> | ||
$ rclone listremotes | |||
You can probe available disk space with | <!--T:46--> | ||
You can probe available disk space with | |||
$ rclone about nextcloud: | <!--T:47--> | ||
$ rclone about nextcloud: | |||
<!--T:48--> | |||
To upload a file, run | To upload a file, run | ||
$ rclone copy /path/to/local/file nextcloud:remote/path | <!--T:49--> | ||
$ rclone copy /path/to/local/file nextcloud:remote/path | |||
<!--T:50--> | |||
To download a file, run | To download a file, run | ||
$ rclone copy nextcloud:remote/path/file . | <!--T:51--> | ||
$ rclone copy nextcloud:remote/path/file . | |||
=Sharing files using Nextcloud = <!--T:33--> | ==Sharing files using Nextcloud== <!--T:33--> | ||
<!--T:34--> | <!--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). | 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 | 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. | ||
</translate> | </translate> |
Latest revision as of 15:50, 12 June 2024
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]
[name@server ~]$ curl -k -u <username> -T <filename> https://nextcloud.computecanada.ca/remote.php/webdav/
Download a file using curl
[edit]
[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.