Table of Contents

• Description
• What is filestash
• AI Disclosure
• Icons credits
• Why did I made them
• Customization
• List of plugins
• Docker image compatibility
• How to install
• Showcase theme plugin
• Showcase archive_viewer plugin
• License

Description

Selfmade runtime plugins for filestash made for fun (or suffering?).
I'm not affiliated in any way to the creator of filestash or the official project, this is purely a homelab/fun like project.

What is filestash

Filestash is a web interface to access your different filesystems created by mickael-kerjean (https://github.com/mickael-kerjean).
You can check the official github here:
https://github.com/mickael-kerjean/filestash
You can also check the official website:
https://www.filestash.app/

AI Disclosure

I used AI agents to help me doing it (vibecoding).

Icons credits

Nearly all icons have been donwloaded from iconpacks.net (free of use)
Icon by Iconpacks

Why did I made them

I wanted a different look for my filestash and I wanted to be able to browse my archive files.
I love wasting my time.
For the theme, I wasn't aiming for anything in particular, I changed many times but I'm sure you will recognise what it ended up looking like.

Customization

You can change every icons of the plugins and put what you want.
You can go in theme.patch/theme.css & archive_viewer.js/archive_viewer.css and change the icons with this format "data:/...". The icons are all svg images.

List of plugins

theme.zip

-A different visual theme for filestash
-Icons for multiple file extensions
-Branding (you can change it, like anything else)
-Compatible big & small screens
-Compatible touch screen (touch and hold to select)

archive_viewer.zip

-Browse archive files
-View non binary files
-Extract & download one or multiple files
-Compatible big & small screens

Docker image compatibility

Compatible with the latest docker image available as I write this (January 28, 2026).
https://hub.docker.com/r/machines/filestash/tags
Digest: sha256:fb9c8a6f9674756a83a4f00266f41f43379e3224f58d4050b1e803ffa6956842
tag: 6a80725b2116

How to install

Put the .zip of a plugin in the "plugins" folder of your filestash container. "filestash:/app/data/state/plugins/" (assuming filestash is the name of your volume).

How to do that: Check the name of your volume, either in your docker-compose.yml or:

docker volume ls

Copy the zip in your container (assuming your volume name is "filestash"):

docker cp ./plugins/archive_viewer.zip filestash:/app/data/state/plugins/

Check it worked (assuming your container name is "filestash"):

docker exec -it filestash sh -lc 'ls -la /app/data/state/plugins/'

Restart your filestash container:

docker restart filestash && docker compose ps -a

Clear your cache to see the changes (cloudflare/browser)

Showcase theme plugin

Computer browser

Computer light mode list :

Computer light mode grid :

Computer dark mode list :

Computer dark mode grid :

Mobile browser

Mobile light mode list :

Mobile light mode grid :

Mobile dark mode list :

Mobile dark mode grid :

Showcase archive_viewer plugin

Computer browser archive_viewer

Computer light mode :

Computer dark mode :

Mobile browser archive_viewer

Mobile light mode :

Mobile dark mode :

License

This project is licensed under the MIT License — see the LICENSE file for details.