Staaash docs
Staaash is a drive that lives on your own computer. You put files in, and you get them back from any browser or from the desktop app. Nobody else holds your files. It is free and open source.
Install itRunning with Docker in a few minutes.
Keep a backupSet this up on day one.
Reach it from outsideTailscale, a tunnel or your own domain.
Get the desktop appKeep folders on your computer in sync.
Not sure yet? Read Is Staaash right for you? or try the demo.
What you can do
Section titled “What you can do”- Upload files and folders, and download them again.
- Browse, search, favorite and pin files.
- See photo and video previews.
- Send a link to a file or folder. Add a password or an end date, and turn it off whenever you like.
- Get deleted files back from the trash for 30 days by default.
- Keep a folder on your computer in sync with your drive.
- Share one drive with family or friends, each with a private space and an optional storage limit.
Three promises
Section titled “Three promises”- Your files stay safe. Every change to your storage survives a crash or a restart. When Staaash is not sure what happened, it keeps every file and stops.
- One box to run. Docker, a database and a disk. Nothing else to set up.
- Small on purpose. It is a drive for one person or a small group. It is not a team workspace, and it will not grow into a platform.
What you need
Section titled “What you need”A computer or server with Docker. That can be Linux, or Windows with Docker Desktop. Staaash runs on Intel/AMD and ARM.
On 64-bit Windows you can also skip Docker. See Windows Server.
Already running it
Section titled “Already running it”- Using the Drive and Sharing Files. Upload, find, share and get things back.
- Updating and Configuration.
- Reverse Proxy. Your own domain name, with HTTPS.
- Storage Check. When a file says it needs a check.
- Troubleshooting and the FAQ.
- Your Account. Your own settings.
Running it for other people
Section titled “Running it for other people”How it is built
Section titled “How it is built”Four parts work together. You only need this if something breaks.
| Part | What it does |
|---|---|
| Web app | The pages you click on. |
| Worker | A helper in the background. It makes previews and cleans up. |
| Database (PostgreSQL) | Remembers names, folders, people and share links. |
| Storage folder | Holds the real files on your disk. |
The database and the storage folder go together. Always back up both.
Help and contact
Section titled “Help and contact”- Questions and ideas: GitHub Discussions
- Bugs: issue tracker
- Security problems, privately: security policy
- The code: github.com/itsmeares/staaash