indexof: a plain file server for the home network

Self-hosted file server for the household: the shared drive for documents, photos, backups and whatever gets passed around at home, reached from any browser. It looks like nginx's own "Index of /" page, because that is what it is. On top of the listing: a login, uploads, rename and delete, search, folder sizes and zips; videos and music play too, in the browser or in VLC. Two Docker containers, two secrets, and the folders you mount.

Source: https://github.com/lborruto/indexof

indexof's listing of a Documents folder: nginx's plain Index of / table with sizes and dates, [zip], [rename] and [delete] on each line, the search and sort line above, and the upload line with the free space below

Why build this

Nextcloud, File Browser and copyparty are good at what they do, and they do a lot: accounts, sharing, previews, thumbnails, apps. For one disk on a home server, shared with the household, most of that goes unused and all of it has to be kept up to date.

nginx already serves files and lists folders with autoindex. That page is fast, works on anything, and needs no maintenance. What it lacks is a handful of things you reach for every week:

indexof adds exactly that list and nothing else. The listing stays nginx's listing.

How it works

Browser
    │  login (one shared password, cookie)
    │  listing, sort, filter, pages of 100
    │  uploads, rename, delete (WebDAV)
    │  play / view, signed 12-hour VLC links
    ▼
[nginx: "indexof" container] ── /data: your folders, mounted :ro or writable
    │
    │  internal network only, never published
    ▼
[helper container] ── free space, search, folder sizes
                      zips streamed as they are made
                      ffprobe / ffmpeg copy-only remux, text subtitles

Key choices

How to run it

git clone https://github.com/lborruto/indexof.git && cd indexof
cp .env.example .env
openssl rand -hex 32   # paste as INDEXOF_PASSWORD in .env
openssl rand -hex 32   # paste as INDEXOF_LINK_SECRET in .env
docker compose up -d

In compose.yaml, mount the folders to serve under /data, with :ro for the ones that should only be browsed:

volumes:
  - /srv/documents:/data/Documents
  - /srv/photos:/data/Photos:ro
  - /srv/share:/data/share

Open http://localhost:8099 and log in with the password. The home page lists the mounted folders. The README has the demo folder of generated files to try it without your own data, the VLC Link helpers for Mac and Windows, and the full list of settings.

Keep it on the home network or a VPN: indexof speaks plain HTTP and is not made to face the internet.

More in side-projects

Created 2026-10-31T12:45:13+01:00, updated 2026-10-31T15:54:41+01:00 · History · Edit