# SnowShare

SnowShare is a self-hosted web app for securely sharing files, URLs, and text or code pastes with expiration, view limits, passwords, and QR codes. It is open source and self-hosted, installable on Docker Hub and Proxmox.

Canonical page: https://ourlocalhost.com/app/4602/snowshare

## Description

SnowShare is a self-hosted web app for securely sharing files, URLs, and text or code pastes with expiration, view limits, passwords, and QR codes.

## Platform availability

Available on 2 of 10 platforms: Proxmox, Any server.

## Health score

74/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 4 days ago)
- Popular: 41 (112 GitHub stars)
- Easy to install: 35 (2 install platforms, install notes)
- Security check: 100 (no serious findings, CI, tests)

## Links

- Official website: https://s.romain-pinsolle.fr
- GitHub: https://github.com/TuroYT/snowshare
- Docker Hub: https://hub.docker.com/r/turodev/snowshare
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=snowshare

## Common questions

### Which environment variables must be set before first start?

SnowShare requires DATABASE_URL, NEXTAUTH_URL, NEXTAUTH_SECRET, and ALLOW_SIGNUP. ALLOW_SIGNUP controls whether new users can register.

### How do I configure SnowShare behind a reverse proxy?

Set AUTH_TRUST_HOST to true when running behind a reverse proxy. Also set TRUSTED_PROXY_COUNT to the number of reverse proxies in front of SnowShare.

### Can uploaded files be stored outside the app container?

Local uploads are stored in UPLOAD_DIR, an absolute path you map as a volume. If S3_BUCKET is set, local UPLOAD_DIR is ignored.

### Do I need to run database migrations manually?

No, database migrations run automatically when the container starts.

### What login methods are supported?

Users can sign in with email/password or OAuth. Email verification and CAPTCHA are optional.

### What Docker volumes need persistence?

Persist the Postgres db-data volume and the uploads volume so the database and uploaded files survive container recreation.

---
Source: Our Local Host (https://ourlocalhost.com/app/4602/snowshare), the self-hosted and open-source app directory.
