gossa

README

gossa

a fast and simple webserver for your files, that's dependency-free and with under 250 lines of code, easy to review.

a simple UI comes as default, featuring :

• 🔍 files/directories browser & handler
• 📩 drag-and-drop uploader
• 🥂 fast golang static server
• 💾 90s web UI that prints in milliseconds
• 📸 video streaming & picture browser
• ✍️ simple note editor
• ⌨️ keyboard navigation
• 🚀 lightweight and dependency free codebase
• 🔒 >95% test coverage and reproducible builds
• 💑 easy multi account setup, read-only mode
• ✨ PWA enabled

build

built blobs are available on the release page - or simply make build this repo. all builds are reproducible, checkout the hashes on the release page.

arch linux users can also install through the user repos - e.g. yay -S gossa

automatic boot-time startup can be handled with a user systemd service - see support

usage

% ./gossa --help

% ./gossa -h 192.168.100.33 ~/storage

shortcuts

press Ctrl/Cmd + h to see all the UI/keyboard shortcuts.

fancier setups

release images are pushed to dockerhub, e.g. :

# pull from dockerhub and run
% sudo docker run -v ~/LocalDirToShare:/shared -p 8001:8001 pldubouilh/gossa

in a do-one-thing-well mindset, HTTPS and authentication has been left to middlewares and proxies. sample caddy configs are available to quickly setup multi users setups along with https.