Nextcloud User Guide - Revision history

Jhqin: Added section 6.2 for using other command line tools.

2026-05-13T19:57:38Z

Added section 6.2 for using other command line tools.

← Older revision		Revision as of 19:57, 13 May 2026
Line 224:		Line 224:
	\| <code>rclone lsd nextcloud</code> \|\| List only the top-level directories		\| <code>rclone lsd nextcloud</code> \|\| List only the top-level directories
	\|}		\|}
			=== ''' Using other command line tools''' ===

			Other than mounting a Nextcloud storage in your home on Nibi, you can also use commands, such as <code>rclone copy</code> or <code>curl</code> to transfer files to/from Nextcloud. If using these commands to transfer files, only an [[Nextcloud_User_Guide#Step_1: \|App Password]] is accepted when prompted for a password to connect to SHARCNET Nextcloud.

			==== Using <code>rclone copy</code> ====

			Complete steps 1 and 2 in [[Nextcloud_User_Guide#Setup_.26_Configuration \| Setup & Configuration]] for your <code>rclone config</code>, then you can use <code>rclone copy</code> to transfer files.

			For example, if the remote name is `nextcloud-sharcnet` configured in [[Nextcloud_User_Guide#Step_2: \| Step 2]], to upload a file, run

			<source lang="bash">
			rclone copy /path/to/local/file nextcloud-sharcnet:remote/path/
			</source>

			To download a file, run

			<source lang="bash">
			rclone copy nextcloud-sharcnet:remote/path/file .
			</source>

			==== Using <code>curl</code> ====

			Follow [[Nextcloud_User_Guide#Step_1:\|step 1]] to generate an App Password if you haven't done that yet, then you can use <code>curl</code> to transfer files.

			To upload a file, run
			<source lang="bash">
			curl -k -u <username> -T <filename> https://nextcloud.sharcnet.ca/remote.php/webdav/
			</source>

			When prompted to "Enter host password for user <username>", enter your App Password.

			To download a file, run

			<source lang="bash">
			curl -k -u <username> https://nextcloud.sharcnet.ca/remote.php/webdav/<filename> -o <filename>
			</source>

			When prompted to "Enter host password for user <username>", enter your App Password.

Fgarlejo: /* Accessing Sharcnet's Nextcloud */

2026-05-13T16:26:25Z

Accessing Sharcnet's Nextcloud

← Older revision		Revision as of 16:26, 13 May 2026
Line 19:		Line 19:
	The Nextcloud landing page offers two login options:		The Nextcloud landing page offers two login options:

	~~Direct~~ Login — For ~~local application~~ users ~~only~~ (~~e.g~~., ~~administrators). Most researchers will not~~ use this option.		DRAC Login — For users with a Digital Research Alliance of Canada (DRAC / AllianceCAN) account. If you are a registered DRAC user, use this option to sign in.

	~~SSO & SAML~~ Login — For users ~~with a Digital Research Alliance of Canada~~ (~~DRAC / AllianceCAN~~) ~~account~~. ~~If you are a registered DRAC user,~~ use this option ~~to sign in~~.		Admin Login — For local application users only (e.g., administrators). Most researchers will not use this option.

	== '''User Policy''' ==		== '''User Policy''' ==

Bge: /* Step 4: */

2026-05-11T20:03:59Z

Step 4:

← Older revision		Revision as of 20:03, 11 May 2026
Line 210:		Line 210:
	! Commands !! Explanation		! Commands !! Explanation
	\|-		\|-
	\| ''rclone config''\|\| Interactive setup for creating new remotes		\| <code>rclone config</code>\|\| Interactive setup for creating new remotes
	\|-		\|-
	\| ''rclone config edit''\|\| Modify settings of an existing remote		\| <code>rclone config edit</code>\|\| Modify settings of an existing remote
	\|-		\|-
	\| ''rclone config delete''\|\| Remove a remote from the configuration		\| <code>rclone config delete</code>\|\| Remove a remote from the configuration
	\|-		\|-
	\| ''rclone listremotes''\|\| List names of all configured remotes		\| <code>rclone listremotes</code>\|\| List names of all configured remotes
	\|-		\|-
	\| ''rclone config show''\|\| Display detailed settings for all remotes		\| <code>rclone config show</code>\|\| Display detailed settings for all remotes
	\|-		\|-
	\| ''rclone ls nextcloud''\|\| List all files recursively (Slow on large shares)		\| <code>rclone ls nextcloud</code>\|\| List all files recursively (Slow on large shares)
	\|-		\|-
	\| ''rclone lsd nextcloud'' \|\| List only the top-level directories		\| <code>rclone lsd nextcloud</code> \|\| List only the top-level directories
	\|}		\|}

Bge: /* Step 3: */

2026-05-11T19:43:41Z

Step 3:

← Older revision		Revision as of 19:43, 11 May 2026
Line 152:		Line 152:
	1. Create the mount point directory		1. Create the mount point directory

	''mkdir -p ~/my_nextcloud_storage''		<source lang="bash">
			mkdir -p ~/my_nextcloud_storage
			</source>

	2. Clear any stale "ghost" mounts from previous sessions		2. Clear any stale "ghost" mounts from previous sessions

	''fusermount -uz ~/my_nextcloud_storage 2>/dev/null''		<source lang="bash">
			fusermount -uz ~/my_nextcloud_storage 2>/dev/null
			</source>

	3. Execute the mount in the background		3. Execute the mount in the background

	''rclone mount nextcloud-fg: ~/my_nextcloud_storage --vfs-cache-mode full --log-file ~/rclone_log.txt --log-level INFO --daemon''<br>		<source lang="bash">
			rclone mount nextcloud-fg: ~/my_nextcloud_storage --vfs-cache-mode full --log-file ~/rclone_log.txt --log-level INFO --daemon
			</source>

	'''Command Breakdown:'''		'''Command Breakdown:'''

	''rclone mount nextcloud-fg: ~/my_nextcloud_storage'':		* <code>rclone mount nextcloud-fg: ~/my_nextcloud_storage</code>: Connects your <code>nextcloud-fg</code> configuration to the folder named <code>my_nextcloud_storage</code> in your home directory.

	~~Connects your "nextcloud~~-~~fg" configuration to~~ the folder ~~named "my_nextcloud_storage" in your home directory~~.		* <code>--vfs-cache-mode full</code>: Makes the cloud folder act like a real hard drive by saving temporary copies of files locally so you can open and edit them easily.

	''--~~vfs~~-~~cache-mode full''~~:		* <code>--log-file ~/rclone_log.txt</code>: Saves all status messages and errors into a file called rclone_log.txt.

	~~Makes the cloud folder act like a real hard drive by saving temporary copies of files locally so you can open and edit them easily~~.		* <code>--log-level INFO</code>: Records general status updates (not just errors) in that log file.

	''--~~log-file ~~~/~~rclone_log.txt'':~~		* <code>--daemon</code>: Runs the whole process in the background so you can keep using your terminal window.

	~~Saves all status messages and errors into a file called rclone_log.txt.~~

	~~''--log-level INFO'':~~

	~~Records general status updates (not just errors) in that log file.~~

	~~''--daemon''~~:

	Runs the whole process in the background so you can keep using your terminal window.

	==== Step 4: ====		==== Step 4: ====

Bge: /* Step 4: */

2026-05-11T19:30:47Z

Step 4:

← Older revision		Revision as of 19:30, 11 May 2026
Line 192:		Line 192:
	1. Check the log file to see upload status and activity.		1. Check the log file to see upload status and activity.

	''tail -f ~/rclone_log.txt''		<source lang="bash">
			tail -f ~/rclone_log.txt
			</source>

	2. Check the active processes		2. Check the active processes

	''ps -ef \| grep rclone''		<source lang="bash">
			ps -ef \| grep rclone
			</source>

	3. Stop/Unmount the Storage		3. Stop and Unmount the Storage

	''fusermount -uz ~/my_nextcloud_storage''		<source lang="bash">
			fusermount -uz ~/my_nextcloud_storage
			</source>

	4. Some rclone commands		4. Some rclone commands

Fgarlejo: /* Disaster Recovery vs. User Backups */

2026-05-11T17:33:57Z

Disaster Recovery vs. User Backups

← Older revision		Revision as of 17:33, 11 May 2026
Line 49:		Line 49:
	* Accidental Deletions and File Recovery: Nextcloud provides two ways to recover files:		* Accidental Deletions and File Recovery: Nextcloud provides two ways to recover files:

	~~* *~~ Trash Bin — Deleted files can be restored within 30 days by going to Files > Deleted Files and clicking Restore.		# Trash Bin — Deleted files can be restored within 30 days by going to Files > Deleted Files and clicking Restore.
	*		# Version History — Previous versions of a file can be restored by clicking the "..." menu next to the file > Details > Versions tab, then selecting the version you want to restore.
	~~* *~~ Version History — Previous versions of a file can be restored by clicking the "..." menu next to the file > Details > Versions tab, then selecting the version you want to restore.

	=== ''Access and Authentication'' ===		=== ''Access and Authentication'' ===

Fgarlejo: /* Disaster Recovery vs. User Backups */

2026-05-11T17:33:23Z

Disaster Recovery vs. User Backups

← Older revision		Revision as of 17:33, 11 May 2026
Line 49:		Line 49:
	* Accidental Deletions and File Recovery: Nextcloud provides two ways to recover files:		* Accidental Deletions and File Recovery: Nextcloud provides two ways to recover files:

	* Trash Bin — Deleted files can be restored within 30 days by going to Files > Deleted Files and clicking Restore.		* * Trash Bin — Deleted files can be restored within 30 days by going to Files > Deleted Files and clicking Restore.
			*
	* Version History — Previous versions of a file can be restored by clicking the "..." menu next to the file > Details > Versions tab, then selecting the version you want to restore.		* * Version History — Previous versions of a file can be restored by clicking the "..." menu next to the file > Details > Versions tab, then selecting the version you want to restore.

	=== ''Access and Authentication'' ===		=== ''Access and Authentication'' ===

Fgarlejo: /* Storage Allocation and Quotas */

2026-05-11T15:44:52Z

Storage Allocation and Quotas

← Older revision		Revision as of 15:44, 11 May 2026
Line 27:		Line 27:
	=== ''Storage Allocation and Quotas'' ===		=== ''Storage Allocation and Quotas'' ===

	* Individual Quota: Each user is allocated 100 GB of storage; ~~if you need more storage~~, ~~please use~~ Nibi+Globus.		* Individual Quota: Each user is allocated 100 GB of storage by default. Users requiring additional storage may submit a request for a quota increase; otherwise, we recommend using Nibi+Globus for larger datasets.

	* Over-Quota Behavior: When 100 GB is reached, synchronization will stop and you will be unable to upload new files until you delete some files, freeing space.		* Over-Quota Behavior: When 100 GB is reached, synchronization will stop and you will be unable to upload new files until you delete some files, freeing space.

Bge: /* User Policy */

2026-05-11T14:55:34Z

User Policy

Bge: /* Key Features */

2026-05-11T14:35:01Z

Key Features

← Older revision		Revision as of 14:35, 11 May 2026
Line 5:		Line 5:
	== '''Key Features''' ==		== '''Key Features''' ==

	• Access Anywhere: Use a web browser, desktop app, or mobile device to reach your files whenever you need them.		* '''Access Anywhere''': Use a web browser, desktop app, or mobile device to reach your files whenever you need them.

	• Nibi Cluster Integration (Direct Access in /home): You can access your Nextcloud files directly within the Nibi cluster. Your storage is mapped into your home directory, allowing you to move data between the cluster and your private cloud without needing to download and re-upload files.		* '''Nibi Cluster Integration''' (Direct Access in /home): You can access your Nextcloud files directly within the Nibi cluster. Your storage is mapped into your home directory, allowing you to move data between the cluster and your private cloud without needing to download and re-upload files.

	• Secure Sharing: Send files to colleagues or external partners using password-protected links or "drop folders" where others can upload files to you safely.		* '''Secure Sharing''': Send files to colleagues or external partners using password-protected links or "drop folders" where others can upload files to you safely.

	• Automatic Sync: Any changes you make to a file on your computer/mobile (nextcloud client app) are automatically updated on the server.		* '''Automatic Sync''': Any changes you make to a file on your computer/mobile (nextcloud client app) are automatically updated on the server.

	== '''Accessing Sharcnet's Nextcloud''' ==		== '''Accessing Sharcnet's Nextcloud''' ==

← Older revision		Revision as of 14:55, 11 May 2026
Line 25:		Line 25:
	== '''User Policy''' ==		== '''User Policy''' ==

	=== ''Storage Allocation & Quotas'' ===		=== ''Storage Allocation and Quotas'' ===

	• Individual Quota: Each user is allocated 100 GB of storage; if you need more storage, please use Nibi+Globus.		* Individual Quota: Each user is allocated 100 GB of storage; if you need more storage, please use Nibi+Globus.

	• Over-Quota Behavior: When 100 GB is reached, synchronization will stop and you will be unable to upload new files until you delete some files, freeing space.		* Over-Quota Behavior: When 100 GB is reached, synchronization will stop and you will be unable to upload new files until you delete some files, freeing space.

	=== ''Data Retention & Recovery'' ===		=== ''Data Retention and Recovery'' ===

	==== ~~<small>~~Self-Service Recovery (Trash Bin)~~</small>~~ ====		==== Self-Service Recovery (Trash Bin) ====

	• Deleted files are moved to the Trash Bin and retained for up to 30 days.		* Deleted files are moved to the Trash Bin and retained for up to 30 days.

	• Deleted files ~~are~~ moved to the Trash Bin ~~and~~ will be automatically removed after 30 days. However, the Trash Bin is limited to 50% of your remaining available storage quota. If your deleted files exceed this limit, the oldest deleted files will be permanently removed before the 30-day period to free up space — without prior notice.		* Deleted files moved to the Trash Bin will be automatically removed after 30 days. However, the Trash Bin is limited to 50% of your remaining available storage quota. If your deleted files exceed this limit, the oldest deleted files will be permanently removed before the 30-day period to free up space — without prior notice.

	Example: If your total quota is 100 GB and you have used 60 GB, your remaining free space is 40 GB and your Trash Bin limit will be 40 GB (50% of 40 GB) — meaning any deleted files beyond this limit will be permanently removed automatically, even before the 30-day period.		Example: If your total quota is 100 GB and you have used 60 GB, your remaining free space is 40 GB and your Trash Bin limit will be 40 GB (50% of 40 GB) — meaning any deleted files beyond this limit will be permanently removed automatically, even before the 30-day period.

	==== ~~<small>~~Disaster Recovery vs. User Backups~~</small>~~ ====		==== Disaster Recovery vs. User Backups ====

	• The infrastructure is backed up daily to a TSM Tape Library for Disaster Recovery only — not for restoring individually deleted files.		* The infrastructure is backed up daily to a TSM Tape Library for Disaster Recovery only — not for restoring individually deleted files.

	• Users are responsible for maintaining their own secondary copies of critical data. Nextcloud is a Sync & Share platform, not a long-term archive.		* Users are responsible for maintaining their own secondary copies of critical data. Nextcloud is a Sync & Share platform, not a long-term archive.

	• Accidental Deletions & File Recovery: Nextcloud provides two ways to recover files:		* Accidental Deletions and File Recovery: Nextcloud provides two ways to recover files:

	• Trash Bin — Deleted files can be restored within 30 days by going to Files > Deleted Files and clicking Restore.		* Trash Bin — Deleted files can be restored within 30 days by going to Files > Deleted Files and clicking Restore.

	• Version History — Previous versions of a file can be restored by clicking the "..." menu next to the file > Details > Versions tab, then selecting the version you want to restore.		* Version History — Previous versions of a file can be restored by clicking the "..." menu next to the file > Details > Versions tab, then selecting the version you want to restore.

	=== ''Access & Authentication'' ===		=== ''Access and Authentication'' ===

	• SSO Only: Access is strictly via AllianceCAN Single Sign-On.		* SSO Only: Access is strictly via AllianceCAN Single Sign-On.

	• Credentials are confidential — do not share your account or password with anyone. Each person requiring access must have their own account.		* Credentials are confidential — do not share your account or password with anyone. Each person requiring access must have their own account.

	• Session Management: Sessions remain active until the user explicitly logs out. Closing the browser or shutting down your computer does not end your session. Users are responsible for logging out after each use, especially on shared or public computers.		* Session Management: Sessions remain active until the user explicitly logs out. Closing the browser or shutting down your computer does not end your session. Users are responsible for logging out after each use, especially on shared or public computers.

	• App Passwords: For third-party clients (Rclone, WebDAV, mobile apps), generate an App Password under Settings > Security. Do not reuse your DRAC account password.		* App Passwords: For third-party clients (Rclone, WebDAV, mobile apps), generate an App Password under Settings > Security. Do not reuse your DRAC account password.

	=== ''Acceptable Use'' ===		=== ''Acceptable Use'' ===
Line 67:		Line 67:
	All use of this platform is subject to the [https://cdn.sanity.io/files/j00ycr3h/production/8737bbb5a9ec9633026858e3e90cd682b185fcbf.pdf Alliance Federation - Terms of Service]. The following additional rules apply specifically to this Nextcloud instance:		All use of this platform is subject to the [https://cdn.sanity.io/files/j00ycr3h/production/8737bbb5a9ec9633026858e3e90cd682b185fcbf.pdf Alliance Federation - Terms of Service]. The following additional rules apply specifically to this Nextcloud instance:

	• Sensitive Data: This platform is intended for non-sensitive research data by default. If your research involves Personal Information (PI) or Personal Health Information (PHI), contact the administrators before storing it here.		* Sensitive Data: This platform is intended for non-sensitive research data by default. If your research involves Personal Information (PI) or Personal Health Information (PHI), contact the administrators before storing it here.

	• External Sharing: Public links must have a password and expiration date when shared with collaborators who do not have DRAC accounts.		* External Sharing: Public links must have a password and expiration date when shared with collaborators who do not have DRAC accounts.

	=== ''Security & Incident Reporting'' ===		=== ''Security and Incident Reporting'' ===

	• Report any suspected unauthorized access or security incident to help@sharcnet.ca immediately.		* Report any suspected unauthorized access or security incident to help@sharcnet.ca immediately.

	• If your account is compromised, work with administrators and your institution to resolve it.		* If your account is compromised, work with administrators and your institution to resolve it.

	• When collaborating, follow the principle of least privilege — grant only the minimum permissions needed.		* When collaborating, follow the principle of least privilege — grant only the minimum permissions needed.

	== '''User Documentation''' ==		== '''User Documentation''' ==