QuickDrop is a self-hosted file sharing app for fast, anonymous uploads with chunked transfer, optional encryption, per-file passwords, share tokens with expiry/download limits, and an admin console to govern storage limits, lifetime policies, cleanup schedules, notifications, and privacy settings.
- Anonymous uploads with chunked upload support for reliable large-file transfers.
- Folder uploads (directory picker) with preserved structure + improved manifest handling.
- Configurable max file size, storage paths (files/logs), and max lifetime (default 30d) with renewals.
- “Keep indefinitely” and “Hide from list” controls (with admin-governed rules; can disable “Keep indefinitely” globally).
- Optional encryption at rest for stored files; per-file passwords supported.
- Optional built-in previews for images and text files.
- Extended previews for PDF / JSON / CSV (and additional formats).
- Configurable preview settings (enable/disable + maximum preview size).
- Syntax highlighting for code previews (including dark theme styling).
- Direct links plus token-based share links with expiration dates and download limits; QR code generation for quick sharing.
- Improved share token validation/uniqueness; download endpoint uses token directly.
- Share tokens are automatically cleaned up when deleting files.
- Hidden files (link-only) and option to disable the public file list entirely; switchable default home page (upload vs. file list).
- Whole-app password mode and separate admin password gate for the admin area.
- Per-file passwords; server-side session tokens for admin/file access.
- CSRF cookie enabled.
- Single-page settings UI; changes apply without app restart.
- Admin dashboard with file list/history, delete (with confirmation), extend life, visibility toggles, and admin dashboard button toggle.
- Dashboard search + pagination for easier browsing at scale.
- Configurable session timeout, file deletion cron expression, and feature flags (file list, admin button, encryption, previews, notifications, etc.).
- Cron expression validation with clearer error handling (and next run visibility when supported).
- Unified file history log for uploads, renewals, downloads (and related actions), including IP + user agent.
- Email and Discord webhook notifications with built-in test actions.
- Optional notification batching (interval minutes configurable) to avoid spam.
- Scheduled cleanup for expired files, missing-file DB rows, expired share tokens, and other maintenance tasks.
- Java 21
- Spring Boot 3.5.x (Spring Web/MVC, Actuator)
- Spring Security (app/admin/password flows, CSRF cookie)
- Spring Data JPA with Hibernate ORM 6.6 (community dialects)
- Spring Cloud Context (refresh scope)
- Flyway for DB migrations
- SQLite with SQLite JDBC driver
- HikariCP connection pooling
- Thymeleaf with Spring Security extras
- Tailwind CSS + custom JS/CSS assets
- Spring Mail (SMTP notifications)
- Maven build tooling
- Docker image for deployment
Installation with Docker
- Pull the Docker image:
docker pull roastslav/quickdrop:latest
- Run the Docker container:
docker run -d -p 8080:8080 roastslav/quickdrop:latest
Optional: Use volumes to persist the uploaded files when you update the container:
docker run -d -p 8080:8080 \
-v /path/to/db:/app/db \
-v /path/to/log:/app/log \
-v /path/to/files:/app/files \
roastslav/quickdrop
Installation without Docker
Prerequisites
- Java 21 or higher
- Maven
- SQLite
- Clone the repository:
git clone https://github.com/RoastSlav/quickdrop.git
cd quickdrop
- Build the application:
mvn clean package
- Run the application:
java -jar target/quickdrop.jar
To update the app, you need to:
- Stop and remove the old container.
- Pull the new image.
- Start the updated container.
If you want to ensure file and database persistence between updates, you can use Docker volumes. (Check docker installation above)
This project is licensed under the MIT License. See the LICENSE file for details.
