kamp/pingvin-share
1
0
Fork 0
mirror of https://github.com/stonith404/pingvin-share.git synced 2024-07-01 23:20:13 +02:00
Code
A self-hosted file sharing platform that combines lightness and beauty, perfect for seamless and efficient file sharing.
56 Commits 3 Branches 64 Tags 20 MiB
TypeScript 99.8%
Dockerfile 0.2%
464406603a
Go to file
Elias Schneider 464406603a
Fix NavBar on mobile
2022-05-13 19:27:12 +02:00
.github/workflows Fix Docker workflow registry 2022-05-11 19:32:15 +02:00
.setup Improve setup 2022-05-12 21:48:37 +02:00
functions Add User Info Page 2022-05-11 13:50:28 +02:00
public Add Open Graph tags 2022-05-05 11:22:47 +02:00
src Fix NavBar on mobile 2022-05-13 19:27:12 +02:00
styles initial commit 2022-04-25 15:15:17 +02:00
.dockerignore initial commit 2022-04-25 15:15:17 +02:00
.env.example Improve setup 2022-05-12 21:48:37 +02:00
.eslintrc.json initial commit 2022-04-25 15:15:17 +02:00
.gitignore Remove PWA build files 2022-04-28 15:22:25 +02:00
appwrite.json initial commit 2022-04-25 15:15:17 +02:00
docker-compose.yml Add feature to send share with email 2022-05-06 10:25:10 +02:00
Dockerfile Fix setup script function path 2022-05-06 12:08:10 +02:00
LICENSE Create LICENSE 2022-04-26 08:15:49 +02:00
next-env.d.ts initial commit 2022-04-25 15:15:17 +02:00
next.config.js Add disable home page option 2022-05-02 22:42:27 +02:00
package-lock.json Add User Info Page 2022-05-11 13:50:28 +02:00
package.json Add User Info Page 2022-05-11 13:50:28 +02:00
README.md Fix typo 2022-05-12 16:13:16 +02:00
tsconfig.json initial commit 2022-04-25 15:15:17 +02:00

README.md


Pingvin Share

Pingvin Share is a self-hosted file sharing platform made for the Appwrite Hackathon.

🎪 Showcase

Demo: https://pingvin-share.dev.eliasschneider.com

✨ Features

  • Create a simple share with a link
  • Secure your share with a visitor limit and a password
  • Share your files with specific emails and send an invitation email
  • Dark mode

⌨️ Setup

At the moment, the setup is a bit time-consuming. I will improve the setup in the future.

1. Appwrite

Pingvin Share uses Appwrite as backend. You have to install and setup Appwrite first

  1. Install Appwrite
  2. Create an Account on your Appwrite instance
  3. Change the _APP_STORAGE_LIMIT variable in the .env file of Appwrite to your prefered max size limit per share

2. Frontend

First of all you have to start the Docker container.

  1. Clone the docker-compose.yml file and the .env.example file from this repository
  2. Rename the .env.example file to .env
  3. Start the container with docker-compose up -d

The container is now running. Now you have to setup the Appwrite structure, but no worries there is a simple setup script.

To run the script run docker-compose exec pingvin-share node scripts/setup.js.

You're almost done, now you have to change your environment variables that they fit to your setup.

  1. Go to your Appwrite console, visit "API Keys" and copy the "Functions API Key" secret to your clipboard.
  2. Paste the key to the APPWRITE_FUNCTION_API_KEY variable in the .env file
  3. Change PUBLIC_APPWRITE_HOST in the .env file to the host where your Appwrite instance runs
  4. Change the rest of the environment variables in the .env that they fit to your preferences
  5. To save the environment variables run docker-compose up -d
  6. Well done! Get a coffee and enjoy Pingvin Share 🎉

⚙️ Additional configurations

SMTP

  1. Enable PUBLIC_MAIL_SHARE_ENABLE in the .env file.
  2. Visit your Appwrite console, click on functions and select the Create Share function.
  3. At the settings tab change the empty variables to your SMTP setup.

💁‍♂️ Known issues / Limitations

Pingvin Share is currently in beta and there are issues and limitations that should be fixed in the future.

  • DownloadAll generates the zip file on the client side. This takes alot of time. Because of that I temporarily limited this function to maximal 150 MB.
  • If a user knows the share id, he can list and download the files directly from the Appwrite API even if the share is secured by a password or a visitor limit.

🖤 Contribute

You're very welcome to contribute to Pingvin Share! Contact me, create an issue or directly create a pull request.