App Submission: Pingvin Share

[MalteKiefer]

App Submission

App name

Pingvin Share

256x256 SVG icon

Sorry, no experience to create a SVG from an PNG

...

Gallery images

I have tested my app on:

• umbrelOS on a Raspberry Pi
• umbrelOS on an Umbrel Home
• umbrelOS on Linux VM

[sharknoon]

Thank you so much @MalteKiefer for your awesome app submission! I have left some suggestions below.

[sharknoon]

I myself also forget to add the submission URL all the time :D

Suggested change

	submission:
	submission: https://github.com/getumbrel/umbrel-apps/pull/1229

[sharknoon]

Taglines should not end with a ..

Suggested change

	tagline: Pingvin Share is self-hosted file sharing platform and an alternative for WeTransfer.
	tagline: Pingvin Share is self-hosted file sharing platform and an alternative for WeTransfer

[sharknoon]

You don't need to expose this port when you are using the app_proxy. This way it is more secure :)

Suggested change

	ports:
	- 6453:3000

[sharknoon]

You can change this port to the internal port of the container.

Note

This port does not need to match the port in the umbrel-app.yml! The port there is the external port, this port is the port in this container network

Suggested change

	APP_PORT: 6453
	APP_PORT: 3000

[sharknoon]

Here we have a very big problem: clamav/clamav does not run on the arm64 architecture. All apps need to run on arm64 as well as amd64. Maybe you can find a replacement for this? Also please don't forget to add the digest (@sha256...) for future images :)

[sharknoon]

Due to privilege issues on older umbrelOS devices, we need to add those directories to the app. Please create the following files:

• pingvin-share/data/images/.gitkeep
• pingvin-share/data/backend/.gitkeep

The problem is that on older versions of umbrelOS (again backwards compatibility) the permissions of automatically created repositories are wrong. By supplying a .gitkeep file, those directories are getting created by installing the app automatically.
Also maybe it would be better to save the backend data separately to prevent the clashing of files:

Suggested change

	- "${APP_DATA_DIR}/data:/opt/app/backend/data"
	- "${APP_DATA_DIR}/data/images:/opt/app/frontend/public/img"
	- "${APP_DATA_DIR}/data/backend:/opt/app/backend/data"
	- "${APP_DATA_DIR}/data/images:/opt/app/frontend/public/img"

[nmfretz]

@MalteKiefer friendly ping to see if you are still working on this. The main issue noted by @sharknoon is that the clamav image is only available for linux/amd64 architectures so the app would be broken for users running umbrelOS on a raspberry pi.

Edit: looks like the clamav container is optional: https://github.com/stonith404/pingvin-share/blob/main/docker-compose.yml
So for now, we could ship this without clamav until a multi-arch image becomes available Cisco-Talos/clamav#482

Edit 2: @sharknoon came across this multi-arch clamav-debian image from the same developers: https://hub.docker.com/r/clamav/clamav-debian/tags

[nmfretz]

Thinking about this more, it seems like Pingvin Share is really only useful when it is exposed to the internet. The easiest way to do this on umbrelOS right now is to:

1. Install the Cloudflare Tunnel app
2. Set up a Cloudflare account outside of umbrelOS and purchase+add a domain
3. Set up a tunnel to the pingvin share web container, bypassing the app proxy.

This is certainly possible for technical users to do, but I think realistically what will happen is that an average user sees this cool looking file share app, installs it, and then becomes frustrated that it doesn't work out of the box.

I propose we convert this to draft and then launch it once umbrelOS has a simple way for users to expose apps to the internet (on the horizon). That way when this hits the official app store, there will be the option for it to work out-of-the-box for users.

In the meantime, technical users could still run Pingvin Share on their Umbrel by either:

• Installing it from a Community App Store https://github.com/getumbrel/umbrel-community-app-store, or
• Installing it via the Portainer app: https://apps.umbrel.com/app/portainer

[dennysubke]

@MalteKiefer
I have adopted pingvin share in my community appstore. Everything is going great. However, the app only makes sense in conjunction with Coudflare.

I propose we convert this to draft and then launch it once umbrelOS has a simple way for users to expose apps to the internet (on the horizon). That way when this hits the official app store, there will be the option for it to work out-of-the-box for users.

What do you mean by that, @nmfretz ?

[nmfretz]

Great to know it's working well on your community app store @dennysubke!

On revisiting this, I think we should send this to the app store with a note at the top of the app description saying that Pingvin Share needs to be exposed to the internet for full functionality. We do this for some other apps (e.g., Plausible), so it doesn't make sense to single out Pingvin Share for this.

We will get gallery assets prepared and I will finalize this submission.

What do you mean by that, @nmfretz ?

I can't give away too much at this point, but we have plans to allow users to easily expose apps to the internet. As noted above though, we shouldn't be waiting for this to bring this app to the app store. Thanks for your input @dennysubke!

[nmfretz]

I have gone through and finalized this submission. I have tested on x86 and arm64, including exposing Pingvin Share to the web using a Cloudflare tunnel.