yoas1/angie-files

Angie Files is a self-hosted web application for managing files through a browser, built on top of Angie, a fork of the NGINX web server, using the WebDAV protocol. It gives you two ways to look at your files: a public directory listing page with a dark theme, search, and a button to reach the admin dashboard, and a locked admin dashboard where you can upload, delete, rename files, and change your password. One folder can be marked as locked and protected with a password, and that password can be set through environment variables when you start the app or changed later from inside the dashboard. The tool also includes a recursive search feature that looks through directories up to four levels deep and shows the full path for each result, so finding a file buried in subfolders does not require browsing through every level by hand. The project is meant to run with Docker or Docker Compose. The basic setup uses a default admin username and password, but you can supply your own through environment variables, and there is a way to keep your password saved across container restarts using a Docker volume, so it does not reset every time you recreate the container. You can also mount your own existing htpasswd file if you already have one, though in that case the username and password environment variables are ignored. File operations such as uploading, listing, and deleting can also be done directly from the command line using curl requests to the app's HTTP endpoints, not only through the dashboard interface. Behind the scenes it combines Angie for serving files and handling WebDAV, a small Python 3 script for the password change feature, and plain HTML, CSS, and JavaScript for the frontend with no external dependencies, matching its stated goal of working in air gapped, offline settings. It ships under the BSD 2-Clause license, a permissive license that allows you to reuse and modify the code freely.