node package manager

droppy

Self-hosted file storage server

droppy is a self-hosted file storage server with an interface similar to desktop file managers, with capabilites to edit files and view media directly in the browser. It is especially well suited to be ran on low-end hardware like the Raspberry Pi.

Features (try the demo)

  • Fully responsive HTML5 interface
  • Realtime updates of changes
  • Directory upload support
  • Drag & drop and swipe gestures
  • Side-by-Side mode
  • Shareable public download links
  • Zip download of directories
  • Powerful editor for text files
  • Image and video gallery, audio player
  • Fullscreen support for media galleries
  • Supports installing to the homescreen

Note that two directories will be used by droppy:

  • config directory: set with --configdir <dir>, default ~/.droppy/config.
  • files directory: set with --filesdir <dir>, default ~/.droppy/files.

Make sure these directories exist and owned by the user running the application/container.

With Node.js >= 0.10 and npm installed, run:

# Install latest version and dependencies. 
$ [sudo] npm install -g droppy
 
# Start with `/srv/droppy/config` for config and `/srv/droppy/files` for files. 
$ droppy start --configdir /srv/droppy/config --filesdir /srv/droppy/files
 
# Open http://localhost:8989/ in your browser. 
# Pull the image and start the container. Port 8989 on the host will be forwarded to the container. 
$ docker run --name droppy -p 8989:8989 -v /srv/droppy/config:/config -v /srv/droppy/files:/files silverwind/droppy
 
# Open http://localhost:8989/ in your browser. 

Note: While it's adviceable that all files in the config and files directory are owned by the user running the container, changing the ownership of the directories is supported through passing the environment variables UID and GID to the container, e.g. docker run -e UID=1000 -e GID=1000.

By default, the server listens on all IPv4 and IPv6 interfaces on port 8989. On first startup, a prompt to create login data for the first account will appear. Once it's created, login credentials are enforced. Additional accounts can be created in the options interface or the command line. Configuration is done in config/config.json, which is created with these defaults:

{
  "listeners" : [
      {
          "host"     : ["0.0.0.0", "::"],
          "port"     : 8989,
          "protocol" : "http"
      }
  ],
  "public"          : false,
  "timestamps"      : true,
  "linkLength"      : 5,
  "logLevel"        : 2,
  "maxFileSize"     : 0,
  "updateInterval"  : 1000,
  "pollingInterval" : 0,
  "keepAlive"       : 20000
}
  • listeners Array - Defines on which network interfaces, port and protocols the server will listen. See listener options below. listeners has no effect when droppy is used as a module.
  • public Boolean - When enabled, no user authentication is performed.
  • timestamps Boolean - When enabled, adds timestamps to log output.
  • linkLength Number - The amount of characters in a shared link.
  • logLevel Number - Logging amount. 0 is no logging, 1 is errors, 2 is info (HTTP requests), 3 is debug (Websocket communication).
  • maxFileSize Number - The maximum file size in bytes a user can upload in a single file.
  • updateInterval Number - Interval in milliseconds in which a single client can receive update messages through changes in the file system.
  • pollingInterval Number - Interval in milliseconds in which the file system is polled for changes, which is likely necessary for files on external or network-mapped drives. This is CPU-intensive! Corresponds to chokidar's usePolling option. 0 disables polling.
  • keepAlive Number - Interval in milliseconds in which the server sends keepalive message over the websocket, which may be necessary with proxies. 0 disables keepalive messages.
  • dev Boolean - Enable developer mode, skipping resource minification and enabling live reload.
#### Listener Options

listeners defines on which network interfaces, ports and protocol(s) the server will listen. For example:

"listeners": [
    {
        "host"     : [ "0.0.0.0", "::" ],
        "port"     : 80,
        "protocol" : "http"
    },
    {
        "host"     : "0.0.0.0",
        "port"     : 443,
        "protocol" : "https",
        "key"      : "~/certs/tls.key",
        "cert"     : "~/certs/tls.crt",
        "ca"       : "~/certs/tls.ca",
        "dhparam"  : "~/certs/tls.dhparam",
        "hsts"     : 31536000
    }
]

The above configuration will result in:

  • HTTP listening on all IPv4 and IPv6 interfaces, port 80.
  • HTTPS listening on all IPv4 interfaces, port 443, with 1 year of HSTS duration, using the provided SSL/TLS files.

A listener object accepts these options:

  • host String/Array - Network interface(s) to listen on. Required.
  • port Number/Array - Network port(s) to listen on. Required.
  • protocol String - Protocol to use, http or https. Required.

For SSL/TLS these additional options are available:

Note: Unless given absolute, SSL/TLS paths are relative to the config folder. If your certificate file includes an concatenated intermediate certificate, it will be detected and used, there's no need to specify ca in this case.

droppy can be used with frameworks like express:

var app    = require("express")();
var droppy = require("droppy")({
  configdir: "~/droppy/config"
  filesdir: "~/droppy/files",
  log: "~/droppy/log",
  logLevel: 0
});
 
app.use("/", droppy);
app.listen(process.env.PORT || 8989);

See the express example for a working example.

  • options {object}: Options. Extends config.json. In addition to above listed options, configdir, filesdir and log are present on the API.

Returns function onRequest(req, res). All arguments are optional.

$ [sudo] npm install -g droppy
$ docker pull silverwind/droppy
$ docker stop droppy
$ docker rm droppy
$ docker run --name droppy -p 8989:8989 -v /srv/droppy/config:/config -v /srv/droppy/files:/files silverwind/droppy

droppy is currently optimized for a moderate amount of files. To aid in performance, all directories are indexed into memory once on startup. The downside of this is that the startup will take considerable time on slow storage with hunderts of thousands of files present.

For correct download filenames of shared links, use --content-disposition or add this to ~/.wgetrc:

content-disposition = on

© silverwind, distributed under BSD licence.