Skip to content

adrianschubek/dir-browser

Repository files navigation

Visit dir.adriansoftware.de for documentation & more!

Demo

https://dir-demo.adriansoftware.de

Features

  • Download counter for all files
  • Secure by default. Read-only access
  • Extremely fast file serving through nginx
  • README markdown rendering support
  • JSON API for programmatic access
  • Batch download of files and folders in a zip archive
  • File integrity checks with hashes
  • Custom descriptions and labels for files and folders
  • Search and sorting built-in
  • Password protection
  • Hide files and folders
  • Light and Dark mode
  • File icons
  • Many Themes available
  • Clean URLs equivalent to file system paths
  • Low memory footprint (~10MB)
  • Easy setup using single Docker image
  • Responsive design for mobile devices and desktop
  • Easily configurable using environment variables
  • File stats like modification dates and sizes
  • Custom JS and CSS support
  • Highlight recently updated files
  • Track request timing
  • arm64 support

Quick start (Docker)

Serve a local folder read-only at http://localhost:8080:

docker run -d \
  --name dir-browser \
  -p 8080:80 \
  -v /my/local/folder:/var/www/html/public:ro \
  -v rdb:/var/lib/redis/ \
  adrianschubek/dir-browser:latest

Documentation