🤝Sharing a Folder
Last updated
Last updated
Sharing a folder is possible. Pupcloud will launch a separate server, on another port, to allow to remap it on a reverse proxy.
In order to set up a share, one or more profiles must be specified. Each profile is in the form name:secret, where the secret must not be shared with the recipient, and it's used to protect the confidentiality of the share.
Relevant CLI parameters are:
--share-profile: a share profile, in the form name:secret (e.g. Family:abc0123). Can be repeated for more profiles.
--share-port: the port for the share server; by default 17179;
--share-prefix: useful when using a reverse proxy, it's the base URL of the share link. By default, http://localhost:17179.
If you need to specify more than one profile, you can repeat the parameter --share-profile.
Sharing is enabled if at least one profile is defined.
In the Web interface, the sharing URL can be obtained using the "share" button for the current folder. A dialog will open:
From here you can set:
A password (optional);
The profile;
If the share must be read-only;
An expiry date (optional).
Pressing then the button at 5, a link will be generated and copied to the clipboard.
If the main app is launched as read-only, all its share links will be read-only. The switch is still enabled, because if in the future the app will be re-launched as read/write, the link will be read/write.
The share can be "revoked" by relaunching pupcloud without a particular profile, or changing the secret of a profile. All the links tied to that profile will be invalidated.