mattintech/simplefileupload-server repository overview

⁠Quick Start

docker run -p 7777:7777 yourusername/simplefileupload-server

The server will be available at http://localhost:7777

⁠Features

• 🚀 Clean, modern UI for file downloads
• 🔒 Secure API authentication for uploads
• 📱 Mobile-friendly upload endpoint
• 🎯 Secure 6-digit alphanumeric code system
• 🧹 Automatic file cleanup
• ⚙️ Configurable download limits and expiry times

⁠Docker Configuration Options

⁠Basic HTTP Setup (Development)

docker run -p 7777:7777 \
  -e CLIENT_KEY=your-secret-key \
  yourusername/simplefileupload-server

⁠HTTPS Setup (Required for Mobile App)

docker run -p 7777:7777 \
  -e CLIENT_KEY=your-secret-key \
  -v $(pwd)/cert.pem:/app/cert.pem \
  -v $(pwd)/key.pem:/app/key.pem \
  yourusername/simplefileupload-server

⁠Persistent Storage

docker run -p 7777:7777 \
  -e CLIENT_KEY=your-secret-key \
  -v $(pwd)/uploads:/app/tmp \
  yourusername/simplefileupload-server

⁠Environment Variables

⁠API Usage Example

Upload a file:

curl -X POST http://localhost:7777/upload \
  -H "X-Client-Key: your-secret-key" \
  -F "file=@/path/to/your/file.txt"

Response:

{
  "code": "ABC123"
}

Download using browser: http://localhost:7777/download/ABC123

⁠Security Recommendations

• Always change the default CLIENT_KEY in production
• Use HTTPS in production by mounting SSL certificates
• Set appropriate file size limits
• Monitor disk usage when using persistent storage

⁠Source Code

Find the full source code and documentation on GitHub⁠

⁠License

MIT