mrkeyoor.com_
Sat 17 Oct 13:35 UTC
Self-Hostedevaluationupdated 26 Aug 2026

filestash review

Filestash is a self-hosted web file manager that puts one interface in front of SFTP, S3, SMB, WebDAV, FTP, and many other storage systems. Its plugin model also adds authentication, file viewers, workflows, protocol gateways, search, and MCP access without requiring users to move their data into a Filestash-owned store.

+19stars / 7d
Verdict

Our Filestash build passed in 21 seconds, but all 109 Go packages failed during the 172-second test step, so source adopters do not have a clean baseline from our run. The product is worth a controlled trial when existing storage protocols must share one web client. Keep destructive WebDAV access away from important S3 or Azure data until issue 994 and its open fix are resolved and verified on your backend.

We ran it

Lab card: what happened when we ran filestashScreenshot of filestash (www.filestash.app)
Install✓ · 119s419 packages
Build✓ · 21s
Tests✗ · 172s0 passed · 109 failed of 109 (go test)
Repo838 files~74,737 lines of source · 15.1 MB · 0 CI workflows

Answers from our run

Does filestash build from source?

Dependencies installed in 119 seconds (419 packages), and the build succeeded in 21 seconds. We cloned commit ce30865 into a clean Debian container with 3 CPUs and no project-specific setup.

Do filestash's tests pass?

No. The project's own test command finished in 172 seconds and reported 0 passed, 109 failed (go test).

Who should not use filestash?

Operators who cannot test destructive file operations: open issue 994 reports WebDAV folder deletion on S3 also deleting a sibling with the same prefix, and the related fix remains an open pull request.

What are the alternatives to filestash?

File Browser, ownCloud Infinite Scale, Nextcloud. Our Filestash build passed in 21 seconds, but all 109 Go packages failed during the 172-second test step, so source adopters do not have a clean baseline from our run.

Setup3/5Docker path is short; production storage and TLS need care
Docs4/5Good deployment and plugin guides, with a sprawling feature set
Community4/514,549 stars and an August 2026 push; issue queue is large
Maturity2/5Long-lived project, but our 109-package test step failed

Discussed on

  1. hnGPT4 simulating a FTP server at ftp.disney.com273 points
  2. hnShow HN: Remote Storage MCP Server for FTP, FTS, SFTP, S3, SMB, NFS, Git5 points
  3. hnFilestash: File Manager/Web Client for SFTP, S3, FTP, Git, MySQL, Backblaze3 points

Who it’s for

Teams that need one browser interface across several existing storage protocols.
Self-hosters willing to put the service behind HTTPS and configure storage authentication carefully.
Developers building custom storage, auth, viewer, workflow, or gateway plugins.
Organizations that need web access to old FTP, SFTP, SMB, or object-storage systems.

Who it’s NOT for

Operators who cannot test destructive file operations: open issue 994 reports WebDAV folder deletion on S3 also deleting a sibling with the same prefix, and the related fix remains an open pull request.
Teams expecting a clean source test baseline: our Go run reported all 109 packages failed at build time during the test step.
Buyers seeking a simple local-folder browser: Filestash's value lies in protocol and plugin breadth, which adds configuration and failure modes a narrower tool avoids.
Organizations that cannot use AGPL-3.0 or arrange suitable commercial terms.
Admins who want automatic TLS in the base deployment: the installation guide says production needs a reverse proxy for SSL termination.

Setup reality

Our sandbox installed 419 Go packages in 119 seconds and built the project in 21 seconds. The test step failed after 172 seconds: go test reported 0 passed and 109 failed out of 109. The log tail lists build failures across Tor, video, chat, console, PGP, favourites, recent items, and other plugins.

The supported quick path uses Docker Compose, exposes port 8334, and asks you to set an admin password in the browser. Useful storage needs backend credentials; production needs a domain, reverse proxy, TLS, persistent state volume, and the chosen authentication and authorization plugins.

Filestash's breadth pulls in native media libraries, FFmpeg, and plugin-specific services. The repository has no root Dockerfile, though docker/ contains image and Compose definitions. MCP access adds another authenticated gateway to storage and should receive the same least-privilege treatment as WebDAV or SFTP.

One web client fronts more than 20 storage backends

Filestash gives FTP, SFTP, S3, SMB, WebDAV, Git, NFS, and other storage systems a shared browser interface. It does not ask a company to migrate those files into a new proprietary store. A backend plugin implements listing, reading, writing, moving, deleting, and related operations, while the web client presents the common controls. That is a practical fit for organizations with several inherited systems and no appetite for several user interfaces.

Plugins go much further than storage. Filestash exposes extension points for authentication, authorization, search, viewers, thumbnails, middleware, workflows, and new endpoints. Its listed file apps cover ordinary documents plus specialist formats used in photography, GIS, engineering, science, and media. The checkout remains fairly compact at 838 files, about 74,737 source lines, and 15.1 MB, though the runtime surface is much wider than those figures suggest.

The 119-second install is the easy part

Our sandbox downloaded 419 Go packages in 119 seconds, then built Filestash successfully in 21 seconds. That proves commit ce30865 could produce its normal build in an unprivileged Debian container with 3 CPUs and 8 GB of RAM. It does not prove that any S3 bucket, SFTP host, directory service, office server, or media converter was configured correctly.

The official installation path uses Docker Compose and publishes the application on port 8334. First launch asks the operator to create an admin password. The supplied Compose file also defines a Collabora service for office documents and persists application state under /app/data/state/. Filestash's guide says a production base deployment needs a reverse proxy to terminate TLS. Storage passwords, cloud keys, and identity-provider settings then depend on the plugins selected.

What happened when we ran it

Our run reached the test step after the 119-second install and 21-second build, then failed after 172 seconds. The Go test summary reported 0 passed and 109 failed out of 109. The final lines identify package build failures in the Tor starter, video thumbnail and transcoder paths, FFmpeg and libav code, chat, console, description, favourites, PGP, and recent-item widgets.

The log tail does not show the compiler messages that caused those package failures, so assigning one missing system library would be speculation. A fresh Debian container can expose undocumented native requirements, and Filestash does use C media libraries plus FFmpeg. The safe conclusion is narrower: the repository built through the harness's build command, while its full go test command did not compile any of the 109 reported packages. Our scan found no CI workflow file and no tests directory.

WebDAV deletion needs a backend-specific safety test

Open issue 994 reports a data-loss case involving WebDAV mounted on Windows and an S3 backend. Deleting a folder named TestBug also deleted sibling TestBugfoo because the request omitted a trailing slash and the object-store operation matched by prefix. The reporter says move had the same pattern and that the web interface itself supplied the slash. Azure appeared to share the relevant code path.

Pull request 996 proposes a fix for S3 and Azure, but it was still open when fetched. Anyone exposing object storage over Filestash's WebDAV gateway should reproduce deletion and move behavior with similarly prefixed folders before granting write access. Backups and object versioning are sensible controls, yet neither makes an unverified destructive path acceptable for routine use. Read-only access is the safer evaluation mode.

MCP turns the same storage into an agent tool

Filestash includes an MCP plugin that lets an AI client work with a configured remote store. The plugin README names FTP, SFTP, S3, WebDAV, SMB, Git, and NFS as possible sources. This can keep files behind one managed service instead of handing each agent separate backend credentials. It also turns a language-model tool call into a file operation, so scope matters more than convenience.

Use a dedicated identity, restrict it to the smallest directory and operation set, and log its actions. Do not give an experimental agent the same credentials used by a human administrator. The WebDAV deletion report is a useful warning here: a gateway can preserve an application's intent while still translating paths incorrectly for the backend. MCP support earns the required mcp tag, though it should not drive adoption before ordinary file operations are proven.

August activity is high, and the queue is large

GitHub recorded 14,549 stars, a last push on August 25, 2026, and 122 combined issues and pull requests. A separate issue search returned 92 open issues. Recent items cover local authentication confusion, FFmpeg 8 transcoding, configuration persistence after Docker recreation, WebDAV behavior, and interface requests. The latest-release endpoint returned no published release, while the deployment examples use the latest container tag. Pinning an image digest is wiser than inheriting an unreviewed upgrade.

Filestash is an unusually flexible bridge across storage generations. That flexibility is the reason to choose it and the reason to test it carefully. Start with one backend, read-only access, a persistent state backup, and TLS at the proxy. Add write operations, gateways, workflows, and MCP only after the exact paths pass realistic recovery tests.

Alternatives

ProjectWhat it isPick it when
File BrowserA smaller web interface for managing files inside a specified directory.pick this instead when the files are local and you do not need Filestash's protocol and plugin catalog.
ownCloud Infinite ScaleA self-hosted file sync and sharing platform built as a set of services.pick this instead when user sync and collaboration are the product, rather than a common client for existing backends.
Nextcloud gh↗A broad self-hosted collaboration server centered on files, sharing, and apps.pick this instead when you want a groupware platform and can accept a larger application stack.

What people are saying

  1. [github-trending] mickael-kerjean/filestash

Sources

  1. Filestash README
  2. Filestash install and upgrade guide
  3. Filestash MCP plugin
  4. WebDAV object-store deletion report
  5. S3 and Azure folder-operation fix
  6. Docker state persistence report

More self-hosted reviews

playport · edge-smart-doh · Comma · ProsperoEden · zulu · node_exporter · the whole board →