Documentation menu

FiloraFS-Litev2.0.0

FiloraFS-Lite overview

Understand the focused local file-storage boundary, access model, and development path.

Updated

Included

FiloraFS-Lite v2.0.0 uses Spring Boot 4.1.1 and Java 25.

  • Multipart file upload with extension, declared media type, and lightweight signature checks
  • Local filesystem storage with UUID filenames and path containment
  • Shared API-key protection
  • File streaming and attachment download
  • File listing, metadata, and deletion
  • Browser API testing page
  • Postman collection and automated tests
  • Minimal public Actuator health endpoint and graceful shutdown

Run and try it first

FiloraFS-Lite creates ./uploads and uses a development-only API key. Run it without .env or an external service, then open http://localhost:8080/api-test to exercise the file APIs.

Product boundary

Lite is intentionally small and does not include users, roles, a metadata database, AWS S3, ownership, pre-signed access, or thumbnails.

  • Use it for learning, prototypes, internal tools, and simple single-host file workflows.
  • Add application-specific authorization before exposing files to untrusted users.
  • Use persistent mounted storage when files must survive restarts or deployments.

Next steps