This project is suspended - for now - as I cannot follow it as it would deserve, due to... lack of time, to make it short. I am quite fond of it, so I really want to restart working on it again; but I cannot say when or how, unfortunately. Thank you all for your appreciation and the support you've shown me, it's been really nice for me working on it so far.
Of course, feel free to fork it as you like; and if I can be of any help on understanding the code, ask away!
Put your files on the browser!
Documentation - Demo - Roadmap
Point pupcloud to a local folder and instantly get its contents exposed as a web application. Browse, manage, share files... in a truly portable way!
Pupcloud doesn't need a database, a config file, nor it leaves .dotfiles on the filesystem; it is packaged as a single executable file (written in Go+Svelte+Typescript), so you'll just need to download and run it.
It is an exercise in minimalism: it aims to be as simple as possible, while retaining all the features you would like it to have. Just run it! It has everything that fits in a pup-sized cloud ;-)
If you are curious, go see the Demo!
It doesn't include HTTPS, as this can be done easily (and much more securely) with a reverse proxy.
See the ROADMAP file for a glimpse of what's in store!
Pupcloud is distributed as a single executable file. Download and unpack the proper file for your OS/arch.
Once done, just execute it with the directory to serve as an argument:
pupcloud -r /my/dirThen, open http://localhost:17178 with a browser. As simple as that!
Run pupcloud --help to see the other config options. You
can also:
-E or --allow-edits);-P/-H);--share-profile, --share-port, --share-prefix)--title);-p);--bind-to);--follow-symlinks);--max-upload-size).By default, it's forbidden to run it as root. Use --allow-root if you (really) want to.
In the file system view, you can click on a file to open it. Currently pupcloud supports:
Detection of file types is done by mime type, and viewing relies on the browser's capabilities.
You can set a password for accessing pupcloud, by using the -P or -H parameter on the commandline.
Using -P, you can specify the password in plain text. There is a more secure option, -H, using which you must
provide the SHA-256 sum of the password you want to use, in (lowercase) hex format.
You can provide the whole hash, or just the first part, of any length you want to keep the commandline short. Of course, the longer the hash, the safer the system.
# Password is "ciao", with 128 bit of strength (truncated at 16 bytes)
pupcloud -r /my/dir -P b133a0c0e9bee3be20163d2ad31d6248You can use this site to hash the password, it doesn't send the password on the net (at least at the time I am writing, you may want to check).
BEWARE: The password is sent in clear text over the net, so always use a HTTPS-capable reverse proxy if you plan to serve over the public internet.
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.
In the Web interface, the sharing URL can be obtained using the "share" button, and specifying:
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. Also, if the main app is launched as read-only, all its share links will be read-only.
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.Sharing is enabled if at least one profile is defined.
Official docker image available. See DockerHub's page for instructions.
Kindly supported by JetBrains for Open Source development.