Skip to content

Latest commit

 

History

History
60 lines (42 loc) · 2.38 KB

readme.md

File metadata and controls

60 lines (42 loc) · 2.38 KB
Raw

gossa

e

build status docker pulls github downloads

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
  • 💾 90s web UI that prints in milliseconds
  • 📸 video streaming, picture browser, pdf viewer
  • ✍️ simple note editor
  • ⌨️ keyboard navigation
  • 🚀 lightweight and dependency free codebase
  • 🔒 >95% test coverage and reproducible builds
  • 🥂 fast golang static server
  • 💑 easy multi account setup, read-only mode
  • ✨ PWA-able
  • 🖥️ multi-platform support

install / build

arch linux (AUR) - e.g. yay -S gossa

nix - e.g. nix-shell -p gossa

mpr

binaries are available on the release page

all builds are reproducible, checkout the hashes on the release page.

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
% mkdir ~/LocalDirToShare
% 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.

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