From 057a45117077cc03346bc6f4a1f4ca12024d1814 Mon Sep 17 00:00:00 2001
From: Mark Hughes
Date: Fri, 16 Aug 2024 17:48:52 +1000
Subject: [PATCH 1/2] chore: drop node 14 support, progress towards node 18
---
.github/workflows/ci.yaml | 2 +-
README.md | 105 +++++++++++++++++++++-----------------
package.json | 2 +-
3 files changed, 61 insertions(+), 48 deletions(-)
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 8c6d6942..34ab5131 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -7,7 +7,7 @@ jobs:
fail-fast: false
matrix:
os: [macOS-latest, ubuntu-latest, windows-latest]
- node: ["14", "16", "18", "20"]
+ node: ["16", "18", "20"]
runs-on: ${{ matrix.os }}
steps:
diff --git a/README.md b/README.md
index 6bf2b2d7..76d0e67d 100644
--- a/README.md
+++ b/README.md
@@ -13,23 +13,25 @@
## Features
-* Responsive, scalable HTML5 interface
-* Realtime updates of file system changes
-* Directory and Multi-File upload
-* Drag-and-Drop support
-* Clipboard support to create image/text files
-* Side-by-Side mode
-* Simple and fast Search
-* Shareable public download links
-* Zip download of directories
-* Powerful text editor with themes and broad language support
-* Image and video gallery with touch support
-* Audio player with seeking support
-* Fullscreen support for editor and gallery
-* Supports installing to the homescreen
-* Docker images available for x86-64, ARMv6, ARMv7 and ARMv8
+
+- Responsive, scalable HTML5 interface
+- Realtime updates of file system changes
+- Directory and Multi-File upload
+- Drag-and-Drop support
+- Clipboard support to create image/text files
+- Side-by-Side mode
+- Simple and fast Search
+- Shareable public download links
+- Zip download of directories
+- Powerful text editor with themes and broad language support
+- Image and video gallery with touch support
+- Audio player with seeking support
+- Fullscreen support for editor and gallery
+- Supports installing to the homescreen
+- Docker images available for x86-64, ARMv6, ARMv7 and ARMv8
## General Information
+
Two directories will be used, one for configuration and one for the actual files:
- `config`: defaults to `~/.droppy/config`, override with `-c /some/dir`
@@ -38,8 +40,10 @@ Two directories will be used, one for configuration and one for the actual files
droppy maintains an in-memory representation of the `files` directory. If you're on slow storage and/or serving 100k or more files, the initial indexing on startup will likely take some time.
## Installation
+
### Local Installation :package:
-With [`Node.js`](https://nodejs.org) >= 12.10.0 installed, run:
+
+With [`Node.js`](https://nodejs.org) >= 18.20.4 installed, run:
```sh
$ yarn global add @droppyjs/cli
@@ -47,7 +51,7 @@ $ yarn global add @droppyjs/cli
$ npm install -g @droppyjs/cli
```
-Then start your server with your configuration options:
+Then start your server with your configuration options:
```sh
$ droppy start -c /srv/droppy/config -f /srv/droppy/files
@@ -57,7 +61,7 @@ $ droppy start -c /srv/droppy/config -f /srv/droppy/files
To make droppy run in the background, you can use the `--daemon` option, thought it is adviced that you install it as a persistent service in your system. For Linux, see these guides:
- [Systemd-based distributions](https://github.com/silverwind/droppy/wiki/Systemd-Installation)
-- [Debian (Pre-Jessie)](https://github.com/silverwind/droppy/wiki/Debian-Installation-(Pre-Jessie))
+- [Debian (Pre-Jessie)]()
- [Nginx reverse proxy](https://github.com/silverwind/droppy/wiki/Nginx-reverse-proxy)
- [Apache reverse proxy](https://github.com/silverwind/droppy/wiki/Apache-reverse-proxy)
@@ -89,7 +93,7 @@ $ npm install -g @droppyjs/cli
### Docker installation :whale:
-We currently publish our images to `ghcr.io/droppyjs/droppy`. You can bind columnes /data and /config should you need.
+We currently publish our images to `ghcr.io/droppyjs/droppy`. You can bind columnes /data and /config should you need.
### docker-compose
@@ -100,6 +104,7 @@ A sample docker-composer file can be found here: https://github.com/droppyjs/dro
See the example [Caddyfile](examples/Caddyfile).
## Configuration
+
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:
```javascript
@@ -129,25 +134,27 @@ By default, the server listens on all IPv4 and IPv6 interfaces on port 8989. On
```
## Options
-- `listeners` *Array* - Defines on which network interfaces, port and protocols the server will listen. See [listener options](#listener-options) below. `listeners` has no effect when droppy is used as a module. The default listens on HTTP port 8989 on all interfaces and protocols.
-- `public` *boolean* - When enabled, no user authentication is performed. Default: `false`.
-- `timestamps` *boolean* - When enabled, adds timestamps to log output. Default: `true`.
-- `linkLength` *number* - The amount of characters in a shared link. Default: `5`.
-- `linkExtensions` *boolean* - Whether shared links should include the file extension. This can be used to allow other software to make a guess on the content of the file without actually retrieving it. Default: `false`.
-- `logLevel` *number* - Logging amount. `0` is no logging, `1` is errors, `2` is info (HTTP requests), `3` is debug (Websocket communication). Default: `2`.
-- `maxFileSize` *number* - The maximum file size in bytes a user can upload in a single file. `0` means no limit. Default: `0`.
-- `updateInterval` *number* - Interval in milliseconds in which a single client can receive update messages through changes in the file system. Default: `1000`.
-- `pollingInterval` *number* - Interval in milliseconds in which the file system is polled for changes, which **may necessary for files on external or network-mapped drives**. Corresponds to chokidar's [usePolling](https://github.com/paulmillr/chokidar#performance) option. This is CPU-intensive. `0` disables polling. Default: `0`.
-- `keepAlive` *number* - Interval in milliseconds in which the server sends websocket keepalive messages, which may be necessary when proxies are involved. `0` disables keepalive messages. Default: `20000`.
-- `uploadTimeout` *number* - Request timeout for upload requests in milliseconds. Default: `604800000` which is 7 days.
-- `allowFrame` *boolean* - Allow the page to be loaded into a `` or `