http-up

library3.2.4jsnpmunverified

http-up is a zero-configuration command-line HTTP server with an interface for file uploads, browsing, and online editing. Current stable version is 3.2.4, with frequent releases addressing security vulnerabilities. It supports TLS, basic auth, thumbnails, and office document editing via LibreOffice. Unlike simple static servers (e.g., http-server), http-up enables uploads, file management (copy/move/delete) in extended mode, and online editing of office and code files. The server runs via npx without installation and generates self-signed TLS certs automatically.

web-framework http-networking devops

npm install http-up

github ↗package ↗

INSTALL

IMPORT

SIG · HTTP-UP

http-up

web-frameworkjavascriptv3.2.4

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Examples of running http-up as a CLI tool: basic serve, custom port, extended mode, authentication, TLS, and help.

# Serve current directory with default options npx http-up . # Serve a specific directory on a custom port npx http-up --port 3999 /path/to/fold # Enable extended mode for file management npx http-up --extend-mode /tmp # Enable basic auth (random accounts) npx http-up --basic . # Enable TLS and basic auth for secure sharing npx http-up --tls --basic /path/to/you # Show help npx http-up --help

http-up --version

Debug

Known issues

breakingVersion 3.0.0 removed the SHARE option, ADMIN console, and file ENCRYPT option.

fix

If you relied on these features, do not upgrade beyond 2.x.

affects: >=3.0.0

breakingVersion 3.0.0 disabled database by default. Log output disable option added.

fix

Enable database with --database flag if needed.

affects: >=3.0.0

deprecatedThe package uses npx for execution; no programmatic API is exported.

fix

Use npx http-up or install globally with npm install -g http-up.

affects: all

gotchaDuring group COPY or MOVE operations in extended mode, target files/folders are overwritten without confirmation.

fix

Ensure target paths are empty or desired before performing these operations.

affects: all

gotchaOffice file editing (docx, odt, etc.) requires LibreOffice installed on the system.

fix

Install LibreOffice or avoid editing office files; plain text/code editing works without it.

affects: all

gotchaTLS mode uses self-signed certificates generated on first run; browsers will show a warning.

fix

Accept the self-signed certificate manually in the browser, or use a reverse proxy with a proper certificate.

affects: all

Errors

Common errors & fixes

npx http-up .

Running without any options works by default, but users may expect specific behavior.

fix

Add flags like --port, --basic, --tls as needed.

Error: EACCES: permission denied, open '/path/to/file'

The user does not have write permission to the directory being served.

fix

Run with appropriate permissions or serve a directory you own.

Cannot find module 'http-up'

Trying to import the package as a module, but http-up is CLI-only and not meant for programmatic use.

fix

Use npx http-up or install globally; do not require/import in code.

Upgrade

Version history

3.2.4latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/western/http-up ↗

packagehttps://www.npmjs.com/package/http-up ↗