https://github.com/adrianschubek/dir-browser

Directory Browser - Browse your files and folders on the web. Easy Docker setup.
https://github.com/adrianschubek/dir-browser

browser directory directory-browser directory-lister docker file-explorer file-manager folder-viewer listing

Last synced: 3 months ago
JSON representation

Directory Browser - Browse your files and folders on the web. Easy Docker setup.

• Host: GitHub
• URL: https://github.com/adrianschubek/dir-browser
• Owner: adrianschubek
• License: mit
• Created: 2023-03-07T23:14:42.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2026-03-24T12:38:40.000Z (3 months ago)
• Last Synced: 2026-03-24T21:19:43.507Z (3 months ago)
• Topics: browser, directory, directory-browser, directory-lister, docker, file-explorer, file-manager, folder-viewer, listing
• Language: PHP
• Homepage: https://dir.adriansoftware.de
• Size: 13.9 MB
• Stars: 16
• Watchers: 1
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


[![](https://user-images.githubusercontent.com/19362349/235141708-34db874f-729c-4e50-b458-a3c0cb5d6c07.png)](https://dir.adriansoftware.de)





  Visit [dir.adriansoftware.de](https://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:

```bash

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

- Docs: https://dir.adriansoftware.de

- Demo: https://dir-demo.adriansoftware.de