germanorizzo/pupcloud repository overview

⁠🐶 Pupcloud⁠

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, 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⁠!

⁠Docker image

The image is based on Alpine. It's a multiarch image for amd64, ARM and ARM64.

Here are the relevant configurations:

Environment variables can be used to configure the various aspects of Pupcloud.

See Running Pupcloud⁠ for more info, and other variables (use with caution, the ones listed here are the "safe" ones).

⁠Example

docker run -d \
 --restart=unless-stopped \
 --name=pupcloud \
 -p 8080:17178 \
 -v /mnt/DockerHome/myDir:/data \
 -e PUID=1001 \
 -e PGID=1001 \
 -e PUP_TITLE="MyPupCloud!" \
 germanorizzo/pupcloud:latest

This command will install and run pupcloud, configuring it to:

• Use port 8080 (Line 4);
• Map a local dir to path /data in the docker environment (Line 5);
• Run the server as user/group 1001:1001 (Lines 6-7);
• Set the title (Line 8).

Note: if you specify PUP_FOLLOW_SYMLINKS, please be aware that the links are resolved in the docker container, so the feature won't probably work. Use multiple bind/mounts inside /data instead.