mugantronix/drop repository overview

⁠DROP

DROP is a lightweight, self-hosted web application for transferring text and files between computers.

⁠Features

• Automatic text synchronization
• Drag-and-drop file uploads
• Drag files directly into the text area
• Finder-style file icons
• Image previews
• 500 ms synchronization polling
• Incremental file-list rendering without reloading existing previews
• Single Docker container
• Persistent /data storage
• Nginx + FastAPI/Uvicorn
• Docker health check
• No database required

⁠Quick start

docker pull mugantronix/drop:latest

docker run -d \
  --name drop \
  -p 8080:80 \
  -v drop-data:/data \
  --restart unless-stopped \
  mugantronix/drop:latest

Open:

http://YOUR_SERVER:8080/drop/

⁠Docker Compose

services:
  drop:
    image: mugantronix/drop:latest
    container_name: drop
    ports:
      - "8080:80"
    volumes:
      - ./data:/data
    restart: unless-stopped

⁠Persistent storage

Mount /data to persistent storage. DROP stores the shared text and uploaded files there:

/data/
├── files/
└── .shared_text

The data survives container upgrades and recreation.

⁠TrueNAS

DROP is designed to work as a single container and can be deployed from the TrueNAS container interface.

Recommended settings:

No separate Nginx, Python, FastAPI, or application container is required.

⁠Configuration

The maximum upload size can be configured with:

DROP_MAX_FILE_MB

The default is 2048 MB.

Example:

docker run -d \
  --name drop \
  -e DROP_MAX_FILE_MB=4096 \
  -p 8080:80 \
  -v drop-data:/data \
  --restart unless-stopped \
  mugantronix/drop:latest

Nginx currently accepts request bodies up to 10 GB. If you need a smaller Nginx limit, change client_max_body_size in nginx.conf.

⁠Building

git clone
.git
cd DROP
docker build -t mugantronix/drop:local .

Run the local image:

docker run --rm \
  -p 8080:80 \
  -v "$(pwd)/data:/data" \
  mugantronix/drop:local

⁠Security

DROP does not currently provide authentication or authorization.

It is intended for trusted networks. Anyone who can access the instance can read, upload, download, and delete shared content.

Do not expose DROP directly to the public Internet without adding an appropriate authentication and access-control layer.

⁠License

MIT License. See LICENSE⁠.