2022-05-02 02:19:33 -05:00
|
|
|
# <div align="center"><img src="https://user-images.githubusercontent.com/58886915/166198400-c2134044-1198-4647-a8b6-da9c4a204c68.svg" width="40"/> </br>Pingvin Share</div>
|
2022-04-25 08:15:17 -05:00
|
|
|
|
2022-10-09 15:30:32 -05:00
|
|
|
Pingvin Share is self-hosted file sharing platform and an alternative for WeTransfer.
|
2022-04-25 08:15:17 -05:00
|
|
|
|
2022-05-06 04:22:38 -05:00
|
|
|
## ✨ Features
|
|
|
|
|
|
2022-10-16 16:04:35 -05:00
|
|
|
- Create a share with files that you can access with a link
|
2022-10-09 15:30:32 -05:00
|
|
|
- No file size limit, only your disk will be your limit
|
2022-10-16 15:54:39 -05:00
|
|
|
- Set a share expiration
|
2022-10-09 15:30:32 -05:00
|
|
|
- Optionally secure your share with a visitor limit and a password
|
2022-11-13 16:39:04 -05:00
|
|
|
- Email recepients
|
2023-01-13 04:16:35 -05:00
|
|
|
- ClamAV integration
|
2022-05-06 04:22:38 -05:00
|
|
|
|
2022-12-08 11:30:12 -05:00
|
|
|
## 🐧 Get to know Pingvin Share
|
|
|
|
|
|
|
|
|
|
- [Demo](https://pingvin-share.dev.eliasschneider.com)
|
|
|
|
|
- [Review by DB Tech](https://www.youtube.com/watch?v=rWwNeZCOPJA)
|
|
|
|
|
|
|
|
|
|
<img src="https://user-images.githubusercontent.com/58886915/167101708-b85032ad-f5b1-480a-b8d7-ec0096ea2a43.png" width="700"/>
|
|
|
|
|
|
2022-05-06 04:22:38 -05:00
|
|
|
## ⌨️ Setup
|
2022-04-25 08:15:17 -05:00
|
|
|
|
2022-10-11 03:24:08 -05:00
|
|
|
> Pleas note that Pingvin Share is in early stage and could include some bugs
|
|
|
|
|
|
2022-12-11 06:38:58 -05:00
|
|
|
### Recommended installation
|
|
|
|
|
|
2022-12-02 14:33:17 -05:00
|
|
|
1. Download the `docker-compose.yml` file
|
|
|
|
|
2. Run `docker-compose up -d`
|
2022-04-25 08:15:17 -05:00
|
|
|
|
2022-10-11 02:17:25 -05:00
|
|
|
The website is now listening available on `http://localhost:3000`, have fun with Pingvin Share 🐧!
|
2022-04-25 08:15:17 -05:00
|
|
|
|
2023-01-13 04:16:35 -05:00
|
|
|
### Integrations
|
|
|
|
|
|
|
|
|
|
#### ClamAV
|
|
|
|
|
|
|
|
|
|
With ClamAV the shares get scanned for malicious files and get removed if any found.
|
|
|
|
|
|
|
|
|
|
1. Add the ClamAV container to the Docker Compose stack (see `docker-compose.yml`) and start the container.
|
2023-01-13 08:11:33 -05:00
|
|
|
2. Docker will wait for ClamAV to start before starting Pingvin Share. This may take a minute or two.
|
2023-01-13 04:16:35 -05:00
|
|
|
3. The Pingvin Share logs should now log "ClamAV is active"
|
|
|
|
|
|
|
|
|
|
Please note that ClamAV needs a lot of [ressources](https://docs.clamav.net/manual/Installing/Docker.html#memory-ram-requirements).
|
|
|
|
|
|
2022-12-11 06:38:58 -05:00
|
|
|
### Additional resources
|
|
|
|
|
|
|
|
|
|
- [Synology NAS installation](https://mariushosting.com/how-to-install-pingvin-share-on-your-synology-nas/)
|
|
|
|
|
|
2022-10-11 16:10:44 -05:00
|
|
|
### Upgrade to a new version
|
|
|
|
|
|
2022-12-02 14:33:17 -05:00
|
|
|
Run `docker compose pull && docker compose up -d` to update your docker container
|
2022-04-30 16:30:23 -05:00
|
|
|
|
2022-10-09 15:30:32 -05:00
|
|
|
## 🖤 Contribute
|
2022-05-06 03:25:10 -05:00
|
|
|
|
2022-10-16 15:54:39 -05:00
|
|
|
You're very welcome to contribute to Pingvin Share! Follow the [contribution guide](/CONTRIBUTING.md) to get started.
|
