Easy Uploader

A self-hosted file and photo sharing app for Unraid. Create password-protected share links — guests visit the URL, enter the password, and upload files directly to your server.

Features

• Password-protected share links with custom URL slugs
• Optional expiry dates per share
• Guests see their own upload history via a 10-day persistent cookie
• Required name and optional comment on every upload
• Admin panel — manage shares, browse all files with thumbnails, delete files
• Bulk ZIP download — select files from the All Files page and download as a single archive
• Settings page — configure blocked file extensions and MIME types from the UI
• Drag-and-drop upload page, mobile friendly
• Single Docker container, two mapped volumes

Quick Start

services:
  easy-uploader:
    image: devlindelfuego/easy-uploader:latest
    ports:
      - "3000:3000"
    volumes:
      - /mnt/user/appdata/easy-uploader/data:/app/data
      - /mnt/user/Photos/uploads:/app/uploads
    environment:
      - ADMIN_USERNAME=admin
      - ADMIN_PASSWORD=your-strong-password
      - SESSION_SECRET=your-long-random-secret
      - MAX_FILE_SIZE_MB=500
      - NODE_ENV=production
      - COOKIE_SECURE=false
      - TRUST_PROXY=false
      - PUID=99
      - PGID=100
    restart: unless-stopped

Visit http://[server-ip]:3000/admin after starting.

Unraid

Community Applications — search for Easy Uploader and install.

Manual template — go to Docker → Add Container and paste:

https://raw.githubusercontent.com/DevlinDelFuego/Easy-Uploader/main/easy-uploader.xml

Volume layout

Each share gets its own subfolder under the uploads path:

/mnt/user/Photos/uploads/
├── mothersday/
└── fathersday/

Map the uploads root to wherever you want files on your array.

Reverse Proxy

Set COOKIE_SECURE=true and TRUST_PROXY=true when running behind any reverse proxy (Nginx Proxy Manager, SWAG, Traefik, Caddy, etc.) so session cookies are marked secure and client IPs are forwarded correctly.

Cloudflare

If using a Cloudflare Tunnel or proxied DNS:

• Set TRUST_PROXY=true and COOKIE_SECURE=true
• Set CLOUDFLARE_BEACON=true if you use Cloudflare Web Analytics (allows the analytics script in the Content Security Policy)
• If your reverse proxy already sends its own Strict-Transport-Security header, set HSTS_MAX_AGE=0 to avoid duplicate HSTS headers

Settings

The admin Settings page (/admin/settings) lets you configure which file types guests are allowed to upload without restarting the container:

• Blocked extensions — one per line (e.g. .exe, .php)
• Blocked MIME types — one per line (e.g. application/x-msdownload)

Changes take effect immediately. A Reset to Defaults button restores the original blocklist.

Environment Variables

Building from Source

git clone https://github.com/DevlinDelFuego/Easy-Uploader.git
cd Easy-Uploader
npm install
npm run dev