benjaminjaklic/nas_readme

NAS System is a self-hosted file storage platform you run on your own hardware, built with a Flask backend and a React frontend. It lets you upload, organize, and share files from a computer or server you control instead of relying on a cloud storage company, and it supports multiple user accounts with different permission levels. Once installed, you get a web dashboard for uploading files up to 20 GB each with a background upload queue, streaming downloads, and in-browser previews for images, PDFs, video, audio, and text. Files carry color-coded tags for organizing and searching, and the system automatically keeps version history so you can restore an older copy of a file. Deleted files move to a trash folder first, with a 30 day retention window and one click restore, before a background job permanently removes them. Sharing works through public links that do not require the recipient to log in. You can password protect a link, set it to expire after a certain time, allow only preview or only download, or make it a one time link that revokes itself after the first download. There is also a personal notes feature with categories like To-Do, Ideas, and Research, plus light and dark themes with a full color picker. For administrators, the system supports role-based access control with per-role storage quotas, such as 100 GB for an Admin role or 10 GB for a regular User role, along with upload and download speed limits per role. Admins can review activity logs, export them as CSV, and see daily usage charts. Security features include CSRF protection, secure cookies, bcrypt password hashing, rate limiting with automatic IP blocking after repeated failed logins, and blocking of dangerous file types like exe or bat on upload. Installation requires Python 3.9 or newer and Node.js 18 or newer. The project ships automated installer scripts for Windows, macOS, and several Linux distributions that install dependencies, build the frontend, generate secure configuration keys, and can register the app as a system service. A manual installation path is also documented for those who prefer to set it up step by step. The project is distributed under a proprietary license and is sold through Gumroad rather than being fully open source.