Sign inSign up

mogeko/rshs

By mogeko

•Updated about 1 month ago

A lightweight file server with WebDAV support

Image
Web servers
1

8.8K

mogeko/rshs repository overview

⁠rshs

Build Test

A lightweight file server with WebDAV support.

  • Browser: open directories as HTML pages, browse and view files
  • WebDAV client: mount as a remote drive (Finder, Explorer, davfs, etc.)
  • Auth: optional HTTP Basic Auth for access control

⁠Installation

docker pull docker.io/mogeko/rshs:latest
# or
docker pull ghcr.io/mogeko/rshs:latest

⁠Quick Start

# Serve ./data on port 8080
docker run --rm -p 8080:8080 -v ./data:/mnt/data mogeko/rshs

# With authentication
docker run --rm -p 8080:8080 -v ./data:/mnt/data \
  mogeko/rshs --user admin:secret123

Open http://localhost:8080 in a browser, or mount as WebDAV:

# Linux (davfs2)
sudo mount -t davfs http://localhost:8080 /mnt/webdav
# macOS (Finder)
Cmd+K → `http://localhost:8080`
# Windows (Explorer)
Map Network Drive → `http://localhost:8080`

⁠Documentation

DocumentDescription
Usage Guide⁠Full usage, auth, shadow files, CLI
Docker & Docker Compose⁠Docker + docker-compose deployment
Kubernetes⁠K8s deployment, PVC, Ingress

⁠Environment Variables

VariableDescriptionDefault
RSHS_ROOT_DIRRoot directory to serve.
RSHS_HOSTBind address0.0.0.0
RSHS_PORTBind port8080
RSHS_USERSuser:pass;... auth pairs—
RSHS_SHADOW_FILEShadow file path—
RSHS_LOGLog level (e.g. debug)—
RSHS_LOG_STYLELog output styleauto

⁠License

MIT License. See LICENSE⁠ for details.

Tag summary

Content type

Image

Digest

sha256:8e9e8315f…

Size

13.9 MB

Last updated

about 1 month ago

docker pull mogeko/rshs