droppy

library12.2.0jsnpmunverified

droppy is a self-hosted file storage server with a web interface for editing files and viewing media directly in the browser. Current stable version is 12.2.0. It is designed to run on low-end hardware like Raspberry Pi and supports Docker images for multiple architectures. Key differentiators include real-time file system updates, drag-and-drop uploads, clipboard support, side-by-side mode, shareable download links, and a powerful text editor with themes and language support. It uses an in-memory file index which can cause slow initial startup for large file sets. Release cadence is irregular; the latest version was published in 2021.

storage productivity

npm install droppy

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · DROPPY

droppy

storagejavascriptv12.2.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

droppy (command)

✓ npx droppy start -c /config -f /files

✗ npm run droppy

droppy is a CLI tool, not a library; use npx or global install

docker run

✓ docker run --name droppy -p 127.0.0.1:8989:8989 silverwind/droppy

✗ docker run droppy

Must specify port mapping and use correct image name

global install

✓ npm install -g droppy

✗ npm install droppy

droppy is designed to be installed globally for CLI usage

Installs droppy globally and starts the server with custom config and files directories.

npm install -g droppy droppy start -c /srv/droppy/config -f /srv/droppy/files # On first run, follow prompts to create admin account

Debug

Known issues

gotchaInitial file indexing may take significant time on slow storage with 100k+ files

fix

Be patient during startup; consider using faster storage or reducing file count

affects: >=12.0.0

gotchaConfig and files directories default to ~/.droppy/config and ~/.droppy/files; ensure they exist or override with -c and -f

fix

Create directories or specify custom paths on startup

affects: >=12.0.0

gotchaRunning with --daemon option is discouraged; use systemd or other service manager for persistent background operation

fix

Set up a systemd service (see wiki) instead of using --daemon

affects: >=12.0.0

Errors

Common errors & fixes

droppy: command not found

droppy is not installed globally or not in PATH

fix

Run 'npm install -g droppy' or use 'npx droppy start'

Error: listen EADDRINUSE :::8989

Port 8989 is already in use

fix

Stop existing process or change port in config

Error: Cannot find module 'droppy'

Running droppy without global install or from wrong directory

fix

Install globally or use full path to droppy executable

Upgrade

Version history

12.2.0latest on npm

Audit

Dependencies

noderequiredRequires Node.js >= 12.10.0 to run

Agent activity

32 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/silverwind/droppy ↗

packagedroppy ↗

homepagehttps://github.com/silverwind/droppy#readme ↗