node package manager



DropShare is the answer to the age-old question of File Transfer:

File Transfer

Similar services include


A few different clients are avaible.


With the web-client you can drag-n-drop or use the normal upload/download.



dropshare /path/to/file.ext

# Example - share your public ssh key with someone
dropshare ~/.ssh/

Example Output

Your file, Sir! (or Ma'am):

wget ''

curl '' -o ''

Python Client

sudo wget '' -O '/usr/local/bin/dropshare'
sudo chmod a+x '/usr/local/bin/dropshare'

Bash Client

sudo wget '' -O '/usr/local/bin/dropshare'
sudo chmod a+x '/usr/local/bin/dropshare'


If you're interested in consulting or setup to run DropShare on your private network at your Home Office, or Business please contact

Quick Start for Running your own DropShare

If you don't want to customize it at all you can install it via npm

  1. Download NodeJS
  2. npm install -g dropshare
  3. dropshare-server
  4. The database will be in dropshare/server/lib/db/db.json

But for production use with a real database

  1. Install NodeJS: Linux Binary | Linux Source | OS X | Windows.

  2. Install redis. See Appendix (below) for installing redis on OS X.

    # Ubuntu Linux sudo apt-get install redis-server

    # OS X brew install redis launchctl load -w ~/Library/LaunchAgents/io.redis.redis-server.plist # see notes below

  3. Install jade, Pakmanager, less, and some other fun things.

    npm install -g jade less pakmanager uglify-js

  4. Install dropshare in your webapps directory (I use connect-vhoster)

    # use mine (or use your own fork) git clone git://

  5. Copy config.default.js to config.js, and customize any server settings you would like.

    cd rsync -a config.default.js config.js

  6. Download dependencies and compile the static assets. (You may wish to look at to understand what it does)

    ./ # possibly needs sudo

  7. Start the server. By default it runs on port 3700 (but if it's different, you'll see it).

    node bin/dropshare-server.js

Server Parameters

The server can take parameters in a few forms. If you are just running a stand-alone server, then you can put them in the config.js file. If you are creating a Dropshare server in code, then you can pass an object in to the create() method exported by lib/index.js.

The parameters all have sensible defaults that should work out of the box, so you don't actually need any of them.

  • client: the path to the public folder for the browser interface. Defaults to ./public
  • storageDir: a path to a directory to store uploaded files. Defaults to ./files.
  • allowUserSpecifiedIds: if true, allow users to specify the ids that files will be stored under.

Running Tests

Run the tests with:

cd tests

The tests depend on being in the same directory as the test script, due to paths to resources and such.


Dropshare is available under the following licenses:

  • MIT
  • Apache 2

Copyright 2011 - 2012 Jamison Dance and AJ ONeal


Installing Redis

brew install redis

mkdir -p ~/Library/LaunchAgents

launchctl unload -w ~/Library/LaunchAgents/io.redis.redis-server.plist 2>/dev/null || true
cp /usr/local/Cellar/redis/2.2.12/io.redis.redis-server.plist ~/Library/LaunchAgents/
launchctl load -w ~/Library/LaunchAgents/io.redis.redis-server.plist

To start redis manually:

redis-server /usr/local/etc/redis.conf

To access the server: redis-cli

Ubuntu Linux

sudo apt-get install redis-server # may be called just 'redis', depending on your distro