A modern, dark, self-hostable cloud drive — upload, organize, and share your files from your own server. Nextcloud-inspired, rebuilt from scratch on a 2026 stack, and designed to run as a single service you can actually own.
Stackfile is a self-hosted cloud drive: a single Next.js service backed by PostgreSQL that stores your files on your own disk and lets you browse, share and mount them over WebDAV. It is for individuals and small teams who want their own file storage without running a full Nextcloud install. The core phases (files, sharing, admin, 2FA/OAuth, search, WebDAV) are built; passkeys, versioning and content search are still on the roadmap, and there are no tagged releases yet.
Everything below is built and working today:
- Drag-and-drop upload with live progress (streamed straight to disk)
- Download, folders (create / rename), breadcrumb navigation, list & grid views
- Trash — soft-delete → restore → delete-forever (with blob cleanup)
- Favorites, a file details panel, and type-aware icons
- Search across your files & folders by name
- Mount as a network drive via WebDAV (Finder / Explorer / mobile) — secured with a per-user app password
- Public share links with optional password (scrypt-hashed) and expiry
- Password-gated public download pages; create / list / revoke from a file's details
- Email + password auth (better-auth), 7-day sessions
- Two-factor authentication (TOTP) with QR setup + backup codes — login is challenged and the session stays locked until the code is verified
- OAuth (Google / GitHub) — activates automatically when credentials are set
- Settings page: profile, change password, 2FA, connected accounts
- The first registered user becomes the instance admin
- Admin panel — instance stats + user management (promote/demote, delete)
- Per-user storage quotas, enforced on upload, with a sidebar usage bar
- Activity log — uploads, folder ops, shares, trash / restore / delete, favorites
Stackfile is a dark, three-pane file manager — sidebar · file list · details —
on a near-black #010003 canvas with a purple → magenta → coral brand gradient.
Clone it and run locally (below) to explore; the demo seeds a few files.
| Layer | Choice |
|---|---|
| Framework | Next.js 16 (App Router, React 19) — full-stack, one service |
| Language | TypeScript 6, end to end |
| Styling | Tailwind CSS v4, Inter + Azeret Mono |
| Database | PostgreSQL 17 + Drizzle ORM (type-safe, snake_case) |
| Auth | better-auth — password, 2FA (TOTP), OAuth, sessions |
| Storage | Pluggable StorageProvider — local disk today, S3-ready |
| Infra | Docker Compose (Postgres + Redis + migrate + app) + GitHub Actions CI |
Built as a modular monolith: one deployable service, cleanly split internally
(auth · files · sharing · admin · activity). See ARCHITECTURE.md.
pnpm install
cp .env.example .env # then set BETTER_AUTH_SECRET
docker compose up -d postgres redis # Postgres :5544, Redis :6379
pnpm db:migrate
pnpm dev # → http://localhost:4000The first account you create becomes the admin.
cp .env.example .env # set a strong BETTER_AUTH_SECRET
docker compose up -d --build # Postgres + Redis + migrations + appServes on http://localhost:4000; uploaded files persist in the storagedata volume.
All config is via environment variables (see .env.example):
| Variable | Description | Default |
|---|---|---|
DATABASE_URL |
PostgreSQL connection string | — |
BETTER_AUTH_SECRET |
Auth signing secret (openssl rand -base64 32) |
— |
STORAGE_LOCAL_PATH |
Which disk / folder files live in | ./storage-data |
STORAGE_MAX_UPLOAD_BYTES |
Max single-upload size | 5 GiB |
GITHUB_CLIENT_ID / _SECRET |
Enable GitHub OAuth | — |
GOOGLE_CLIENT_ID / _SECRET |
Enable Google OAuth | — |
Choose where files live: point
STORAGE_LOCAL_PATHat any disk or folder (D:/StackfileData,/mnt/bigdisk/stackfile, …).
src/
app/
(auth)/ sign in / sign up
(app)/ files · search · activity · trash · admin · settings
s/[token]/ public share pages
api/ upload · download · auth · public share download
lib/
auth/ db/ storage/ files/ sharing/ admin/ activity/ env.ts
drizzle/ generated SQL migrations
docker-compose.yml postgres · redis · migrate · app
| Phase | What | Status |
|---|---|---|
| P0 | Foundation — scaffold, config, storage, schema, Docker, CI | ✅ |
| P1 | Auth — email/password + sessions | ✅ |
| P2 | Files — upload/download/folders/trash/favorites | ✅ |
| P3 | Sharing — public links (password + expiry) | ✅ |
| P4 | Admin — panel + per-user quotas | ✅ |
| P5 | Advanced auth — TOTP 2FA, OAuth, settings | ✅ |
| P6 | Search + activity log | ✅ |
| Flex | WebDAV — mount as a network drive | ✅ |
| — | passkeys, organizations, versioning, realtime, content search | 🔜 |
MIT © Fizzexual