Repository navigation
🚀 Staaash 2.0.0
Staaash 2.0 adds a desktop app that syncs folders, a new design for every screen, and a new web engine.
staaash.org · Try the demo · Install · Update from 1.x · Desktop app
⚠️ Upgrade notes
- Back up your database and files together before upgrading. This release runs 19 database migrations, and four of them remove columns. Going back to 1.x means restoring that backup. See Backup and restore.
docker-compose.ymlchanged. Download it from this release and replace your old one. Keep your own.envand setSTAAASH_VERSIONin it to this release. With the old version left there, the new file starts the old server and it does not come up. If it sayslatest, rundocker compose pullbeforedocker compose up -d. Migrations now run in their ownmigrateservice before the server and worker start.example.envhas new settings:STAAASH_PORT,COMPOSE_PATH_SEPARATOR,COMPOSE_FILEandUPLOAD_STAGING_RETENTION_HOURS. Your.envkeeps working without them.- New release files:
compose.https.ymlandCaddyfile. - Another member's private file, folder, zip or share now answers 404 instead of 403.
- Upload session limits are fixed at 32 per user and 128 per server, and their admin settings are gone. Two preview size settings and the video preview concurrency setting are gone too.
🌟 Highlights

- Desktop app. Sync folders between your computer and your drive on Windows, macOS and Linux. Choose two-way, download only or upload only, leave out subfolders, and see speed and time left. Conflicting versions are both kept, and deletes go to the trash on both sides. The installers are under Downloads below. Guide
- New design. The drive, admin, settings and sign-in are rebuilt, in light and dark, on desktop and phone. Every page uses one list with list and grid views, and phones get a bottom bar and a swiping viewer.
- New engine. A Vite app on a Hono server replaces Next.js. The public API is described in
openapi.jsonand only gains routes and fields within 2.x. - Windows server. Run Staaash on Windows 10, 11 or Server 2019 and newer without Docker. The installer sets up the web app, worker and PostgreSQL as Windows services. Guide
- HTTPS. An optional Caddy setup gets a certificate for your own domain. Guide
- Website. Staaash now has a home at staaash.org, with all the guides in one place.
- Demo. Try Staaash in your browser before installing.
🔒 Security
- Private HTML and SVG files no longer run scripts when opened.
✨ New features
- (branding) Use the desktop drive logo (#511) by @itsmeares
- (desktop) Add the desktop sync client (#423) by @itsmeares
- (desktop) Leave out computer subfolders when adding a folder (#504) by @itsmeares
- (desktop) Pick an update channel and check for updates (#592) by @itsmeares
- (desktop) Send small files in one request and big files in parallel (#499) by @itsmeares
- (desktop) Show browser downloads in Transfers (#490) by @itsmeares
- (desktop) Show synced folder sizes (#479) by @itsmeares
- (desktop) Show total remaining sync progress (#503) by @itsmeares
- (desktop) Show upload speed and time left (#478) by @itsmeares
- (desktop) Use the org.staaash app ID (#588) by @itsmeares
- (files) Upload pasted clipboard files (#456) by @itsmeares
- (install) Add optional HTTPS and a clearer compose file (#593) by @itsmeares
- (media) Give thumbnails their own switch (#495) by @itsmeares
- (site) Add staaash.org with a landing page and the guides (#633) by @itsmeares
- (site) Link the YouTube, Bluesky and X accounts in the footer (#647) by @itsmeares
- (site) Redesign the landing page around a pixel drive mark (#639) by @itsmeares
- (site) Restyle the docs to match the landing page (#640) by @itsmeares
- (ui) Redesign the drive, admin, settings and sign-in (#373) by @itsmeares
- (uploads) Fold waiting files of a large batch into a count (#550) by @itsmeares
- (web) Add a browser-only demo for GitHub Pages (#509) by @itsmeares
- (web) Add a database-free frontend preview (#449) by @itsmeares
- (windows) Run the server natively on Windows (#541) by @itsmeares
- Move to Vite and Hono and serve the desktop sync client (#416) by @itsmeares
🏎️ Performance (24)
- (archives) Bound selection metadata reads (#374) by @itsmeares
- (db) Turn off PostgreSQL JIT for app connections (#549) by @itsmeares
- (desktop) Hash uploads while sending them (#589) by @itsmeares
- (desktop) Start the next upload while the server checks a sent one (#612) by @itsmeares
- (files) Load continuous lists and save folder totals (#390) by @itsmeares
- (files) Narrow favorites and public share reads (#364) by @itsmeares
- (files) Query upload name conflicts directly (#369) by @itsmeares
- (retrieval) Scope lookups and index file names (#388) by @itsmeares
- (sharing) Scope public reads to shared items (#387) by @itsmeares
- (storage) Avoid repeated file totals (#389) by @itsmeares
- (storage) Check folder trees by lstat before reading every byte (#551) by @itsmeares
- (storage) Index active file-name checks (#425) by @itsmeares
- (storage) Lock only the paths purges and worker publishes touch (#553) by @itsmeares
- (storage) Scope folder changes and batch journal checks (#396) by @itsmeares
- (trash) Empty the trash in the background with progress (#554) by @itsmeares
- (uploads) Read a finished upload once instead of twice (#611) by @itsmeares
- (uploads) Reuse checksum read buffers (#372) by @itsmeares
- (uploads) Save small files in groups (#555) by @itsmeares
- (uploads) Send big uploads in 32 MB pieces (#617) by @itsmeares
- (uploads) Write upload chunks from Node's request stream (#614) by @itsmeares
- (worker) Keep small archives moving during large jobs (#384) by @itsmeares
- (worker) Keep thumbnails moving during large jobs (#397) by @itsmeares
- (worker) Wake idle workers when jobs arrive (#375) by @itsmeares
- (zip) Skip compression when sampled bytes barely shrink (#378) by @itsmeares
🐛 Bug fixes (64)
- (admin) Preserve settings drafts and reset saved values (#356) by @itsmeares
- (admin) Show a restore check that never ran as not run, not a warning (#622) by @itsmeares
- (admin) Show saved settings after leaving the page (#570) by @itsmeares
- (api) Handle malformed JSON and report readiness failures (#357) by @itsmeares
- (api) Keep the share page's waiting step out of the public API (#603) by @itsmeares
- (design) Sharp brand kit, new banner and README art (#623) by @itsmeares
- (desktop) Cancel uploads the app no longer needs, and keep the sync log at sign-out (#613) by @itsmeares
- (desktop) Clear resolved sync errors (#480) by @itsmeares
- (desktop) Fix Linux installer names and metadata (#585) by @itsmeares
- (desktop) Follow big folder changes in the background (#620) by @itsmeares
- (desktop) Include version in sync logs (#543) by @itsmeares
- (desktop) Keep big file ids and report real sync errors (#453) by @itsmeares
- (desktop) Keep sync responsive with a large queue (#546) by @itsmeares
- (desktop) Keep the Linux launcher working after an update installs on quit (#606) by @itsmeares
- (desktop) Keep the upload limit steady with chunks sized to it (#619) by @itsmeares
- (desktop) Keep transfer rows in place (#466) by @itsmeares
- (desktop) Open the matching server release (#454) by @itsmeares
- (desktop) Show account profile photos (#455) by @itsmeares
- (desktop) Stop transfers on pause and show upload stalls in the sync log (#605) by @itsmeares
- (desktop) Wait for space when the server is full (#487) by @itsmeares
- (files) Act on whole selections above 500 items (#489) by @itsmeares
- (files) Add space around custom folder icons (#446) by @itsmeares
- (files) Explain why a trashed file with missing data cannot restore (#501) by @itsmeares
- (files) Keep details inside the panel (#467) by @itsmeares
- (files) Keep list rows spaced with details open (#575) by @itsmeares
- (files) Keep new folder input inside card (#576) by @itsmeares
- (files) Keep shortened names readable (#451) by @itsmeares
- (files) Move folder dates when their contents change (#498) by @itsmeares
- (files) Prevent dropping a folder onto itself (#578) by @itsmeares
- (files) Recognize file types for uploads that send none (#502) by @itsmeares
- (files) Recognize HEIC photos consistently (#459) by @itsmeares
- (files) Refresh Properties preview status automatically (#358) by @itsmeares
- (files) Reject self-drops on pinned folders (#584) by @itsmeares
- (files) Remember dismissed move warnings (#580) by @itsmeares
- (files) Reuse ZIPs only when contents match (#497) by @itsmeares
- (files) Show names in full when they fit (#539) by @itsmeares
- (files) Show selected folder size (#477) by @itsmeares
- (files) Start large folder moves without timing out (#571) by @itsmeares
- (jobs) Keep failures current and add grouped actions (#579) by @itsmeares
- (media) Keep thumbnails until their file is deleted (#591) by @itsmeares
- (previews) Drop unused size limits and cap text previews (#506) by @itsmeares
- (sharing) Make link cards fast and correct (#587) by @itsmeares
- (sharing) Renew expired share links (#457) by @itsmeares
- (site) Answer agents on the home page in Markdown (#641) by @itsmeares
- (storage) Change very large folders in chunks and in the background (#573) by @itsmeares
- (storage) Explain recovery and show next steps (#586) by @itsmeares
- (storage) Keep folders usable when they change as a trash, rename or move starts (#602) by @itsmeares
- (storage) Keep renamed files visible during restore checks (#494) by @itsmeares
- (storage) Keep two names that differ only in case out of one directory (#609) by @itsmeares
- (storage) Keep uploads out of a folder's old path when it is renamed mid-upload (#607) by @itsmeares
- (storage) Let a change commit while another waits for its lock (#615) by @itsmeares
- (trash) Say which items did not move to trash and why (#552) by @itsmeares
- (ui) Remove system theme preview seam (#450) by @itsmeares
- (updates) Clean release notes before saving (#452) by @itsmeares
- (uploads) Apply saved limits without a restart (#582) by @itsmeares
- (uploads) Count the whole batch in Transfers (#522) by @itsmeares
- (uploads) Create the folders of a folder upload in groups (#604) by @itsmeares
- (uploads) Explain disk-margin refusals and align the admin disk card (#547) by @itsmeares
- (uploads) Keep the drive responsive during large upload batches (#548) by @itsmeares
- (worker) Recover stuck preview generation (#583) by @itsmeares
- (worker) Stop abandoned preview temps from locking accounts (#545) by @itsmeares
- (worker) Wait for migrations before startup (#581) by @itsmeares
- Recover upload contention and reduce save latency (#363) by @itsmeares
- Separate readiness from job failures and bound upload admission (#359) by @itsmeares
📖 Documentation (17)
- (brand) Move the demo to the de Vries household (#634) by @itsmeares
- Add AGENTS.md for coding agents (#362) by @itsmeares
- Check issue status before proposing fixes (#445) by @itsmeares
- Improve pull request template (#447) by @itsmeares
- Keep the guides in the repo and publish them to the wiki (#596) by @itsmeares
- Move README to the repo root (#532) by @itsmeares
- New README and 2.0.0 changelog entry (#597) by @itsmeares
- New README and brand kit, with the Rivera family demo drive (#538) by @itsmeares
- Open the live demo from the README picture (#624) by @itsmeares
- Point desktop downloads at v2.0.0-rc.3 (#491) by @itsmeares
- Point Staaash links to staaash.org and move the demo to demo.staaash.org (#637) by @itsmeares
- Prepare desktop signing policy (#512) by @itsmeares
- Prepare readme for rc 4 (#500) by @itsmeares
- Prepare readme for rc 5 (#508) by @itsmeares
- Prepare readme for rc 6 (#542) by @itsmeares
- Prepare readme for rc 7 (#556) by @itsmeares
- Prepare readme for rc.8 (#590) by @itsmeares
📦 Dependencies (48)
- (config) Migrate Renovate config (#628) by @renovate[bot]
- (deps) Update actions/create-github-app-token digest to f418cff (#642) by @renovate[bot]
- (deps) Update app packages (#485) by @renovate[bot]
- (deps) Update dependency @types/node to ^24.19.2 (#370) by @renovate[bot]
- (deps) Update dependency find-my-way to v9.10.0 (#377) by @renovate[bot]
- (deps) Update dependency lucide-react to ^1.69.0 (#567) by @renovate[bot]
- (deps) Update dependency lucide-react to ^1.72.0 (#632) by @renovate[bot]
- (deps) Update dependency lucide-react to ^1.74.0 (#646) by @renovate[bot]
- (deps) Update dependency node to v24.22.2 (#482) by @renovate[bot]
- (deps) Update dependency node to v24.22.3 (#626) by @renovate[bot]
- (deps) Update dependency ubuntu to v26 (#625) by @renovate[bot]
- (deps) Update dependency ubuntu to v26 (#559) by @renovate[bot]
- (deps) Update dependency vite to v8.3.4 (#365) by @renovate[bot]
- (deps) Update dependency vite-plus to v1.7.0 (#645) by @renovate[bot]
- (deps) Update development dependencies (#394) by @renovate[bot]
- (deps) Update development dependencies (#366) by @renovate[bot]
- (deps) Update development tools (#643) by @renovate[bot]
- (deps) Update development tools (#635) by @renovate[bot]
- (deps) Update development tools (#629) by @renovate[bot]
- (deps) Update development tools (#627) by @renovate[bot]
- (deps) Update development tools (#563) by @renovate[bot]
- (deps) Update development tools (#484) by @renovate[bot]
- (deps) Update docker/login-action digest to 8aa5831 (#562) by @renovate[bot]
- (deps) Update github actions (#481) by @renovate[bot]
- (deps) Update github artifact actions (#486) by @renovate[bot]
- (deps) Update node.js to v24.22.0 (#381) by @renovate[bot]
- (deps) Update node.js to v24.22.1 (#410) by @renovate[bot]
- (deps) Update pnpm to v12.10.1 (#361) by @renovate[bot]
- (deps) Update pnpm to v12.11.2 (#371) by @renovate[bot]
- (deps) Update pnpm to v12.14.0 (#395) by @renovate[bot]
- (deps) Update routine patch updates (#402) by @renovate[bot]
- (deps) Update routine patch updates (#393) by @renovate[bot]
- (deps) Update routine patch updates (#379) by @renovate[bot]
- (deps) Update routine patch updates (#376) by @renovate[bot]
- (deps) Update routine patch updates (#360) by @renovate[bot]
- (deps) Update routine patch updates (#355) by @renovate[bot]
- (deps) Update runtime dependencies (#400) by @renovate[bot]
- (deps) Update runtime dependencies (#368) by @renovate[bot]
- (deps) Update tailwind css to ^4.3.4 (#565) by @renovate[bot]
- (deps) Update vite and tests (#566) by @renovate[bot]
- (deps) Update vite and tests to v1.4.0 (#424) by @renovate[bot]
- (deps) Update vite and tests to v1.6.0 (#631) by @renovate[bot]
- (deps) Update vite-plus monorepo to v1.3.0 (#399) by @renovate[bot]
- (deps) Update voidzero-dev/setup-vp digest to 68f39c7 (#392) by @renovate[bot]
- (deps) Update workspace overrides (#644) by @renovate[bot]
- (deps) Update workspace overrides (#630) by @renovate[bot]
- (deps) Update workspace overrides (#564) by @renovate[bot]
- (deps) Update workspace overrides (#483) by @renovate[bot]
🧹 Maintenance (28)
- (ci) Accept PostgreSQL reset errors (#444) by @itsmeares
- (ci) Check both architectures and populated upgrades (#401) by @itsmeares
- (ci) Skip heavy jobs on docs-only pull requests (#536) by @itsmeares
- (ci) Start native tests after their own image build (#422) by @itsmeares
- (ci) Stop outdated runs and split the slow check (#386) by @itsmeares
- (deps) Format renovate config (#430) by @itsmeares
- (deps) Group weekly updates (#409) by @itsmeares
- (deps) Keep compatible brace expansion versions (#429) by @itsmeares
- (desktop) Name installers Staaash-Desktop (#540) by @itsmeares
- (files) Match the folder row in smoke checks (#406) by @itsmeares
- (issues) Improve triage forms (#439) by @itsmeares
- (issues) Stop marking feature requests for triage (#599) by @itsmeares
- (release) Read multi-platform latest metadata (#414) by @itsmeares
- (release) Read the web version from the new image layout (#428) by @itsmeares
- (release) Resume recovery and verify platform manifests (#354) by @itsmeares
- (release) Sign release commits and author releases as the release bot (#507) by @itsmeares
- (release) Simplify desktop downloads (#468) by @itsmeares
- (release) Standardize release notes (#476) by @itsmeares
- (release) Support matching release branches (#411) by @itsmeares
- (release) Write sorted release notes and changelog entries (#594) by @itsmeares
- (storage) Make two storage tests pass on every run (#618) by @itsmeares
- (tooling) Migrate checks to Vite Plus (#383) by @itsmeares
- (tooling) Run shared builds once and lint with Vite Plus (#385) by @itsmeares
- (verify) Make the demo skill portable (#405) by @itsmeares
- Add changelog entry for version 1.2.1 (#415) by @itsmeares
- Bump version to 2.0.0-rc.1 (#427) by @itsmeares
- Enforce checks and add verification skill (#404) by @itsmeares
- Label pull requests by the type in their title (#598) by @itsmeares
🧪 Release candidates
rc.1 · rc.2 · rc.3 · rc.4 · rc.5 · rc.6 · rc.7 · rc.8 · rc.9 · rc.10
📥 Downloads
| Server | |
|---|---|
| 🐳 Docker | docker-compose.yml · example.env · Get started |
| 🪟 Windows | Installer x64 · Windows guide |
| Desktop app | x64 | ARM64 |
|---|---|---|
| Windows | Installer | Installer |
| macOS | Universal DMG | Universal DMG |
| Linux | AppImage · DEB · RPM | AppImage · DEB · RPM |
❤️ Contributors
Thank you @itsmeares.
Full changelog: v1.2.1...v2.0.0
