<img src="https://nmaggioni.github.io/dumpster/dumpster_logo_small.png" alt="Dumpster"/>
A lightweight, self-hosted and API-based file upload server supporting YubiKey OTP authentication.<br> Written in NodeJS and CoffeeScript, persistence layer implemented with LevelDB and page rendering done with Jade.
Table of contents
- Clone the repo.
- Navigate to the cloned directory and run:
npm run-script bower
- Edit the configuration file (see the Configuration section).
- Enjoy Dumpster with
config.json file in the
config directory to configure Dumpster. Be sure to check the related Wiki page for a thoroughly explanation of all the options!
Dumpster is easy to use, and mainly meant to be called from CLI or API. Refer to the related Wiki page for API parameters and their explanation.
If enabled in the configuration with the
enableWebUI option, a simple graphical web interface will be available on the root path. It will follow the
skipAuth setting, requesting an OTP token only if needed. A drag-and-drop upload widget is available, and uploads are performed via AJAX requests.
A live demo is also available on GitHub pages.
Note on persistence
Since version v3.0.0, Dumpster will register and manage deletion dates in a local LevelDB instance (to be found in the
database folder created upon starting the server). That way, if you stop the server and restart it at a later time, it will purge files with older deletion date than the current one and re-schedule future deletions.