Self-hosted cloud storage built with Rust and React.
Single-binary delivery, Alpine container support, storage policies, WebDAV, sharing, version history, trash, thumbnails, and four upload modes.

Highlights

• Single binary delivery - frontend assets are embedded into the Rust server with rust-embed
• Multi-database - SQLite by default, with MySQL and PostgreSQL support through SeaORM
• Pluggable storage policies - local filesystem and S3-compatible object storage, with user-level and folder-level overrides
• Four upload modes - direct, chunked, presigned, and presigned_multipart, negotiated by policy and file size
• Sharing - file and folder sharing with password, expiration time, download limits, public share page, nested shared-folder browsing, child-file download, and shared thumbnails
• WebDAV - dedicated WebDAV accounts, scoped root folder access, database-backed locks, custom properties, and minimal DeltaV version-tree support
• Lifecycle management - trash, version history, thumbnails, locks, periodic cleanup jobs, blob reconciliation, and runtime config management
• Admin console - overview dashboard plus users, storage policies, runtime settings, shares, locks, WebDAV accounts, and audit logs from the frontend panel

Quick start

Run from source

git clone https://github.com/AptS-1547/AsterDrive.git
cd AsterDrive

cd frontend-panel
bun install
bun run build
cd ..

cargo run

On first startup, AsterDrive will automatically:

• generate config.toml in the current working directory if it does not exist
• create the default SQLite database when using the default database URL
• run all database migrations
• create the default local storage policy
• initialize built-in runtime configuration items

Default address:

http://127.0.0.1:3000

The first registered user becomes admin.

Run with Docker

# Build image
docker build -t asterdrive .

# Run container
docker run -d \
  --name asterdrive \
  -p 3000:3000 \
  -e ASTER__SERVER__HOST=0.0.0.0 \
  -e "ASTER__DATABASE__URL=sqlite:///data/asterdrive.db?mode=rwc" \
  -v asterdrive-data:/data \
  asterdrive

# Or use Compose
docker compose up -d

The current container image is an Alpine runtime image. The recommended persistent volume is /data.

See docker-compose.yml and docs/deployment/docker.md for a complete deployment example.

Core capabilities

File management

• hierarchical folders
• file upload, download, rename, move, copy, delete
• directory upload with relative_path auto-folder creation
• inline search and batch operations
• thumbnails and file previews
• version history, restore, and Monaco-based text editing with lock awareness

Storage and delivery

• optional local-only blob deduplication with SHA-256 + reference counting
• local storage and S3-compatible storage policies
• user default policy + folder override
• S3 transport strategies: relay_stream and presigned
• streaming upload/download paths to avoid full-buffer transfers

Collaboration and access

• HttpOnly cookie auth and Bearer JWT support
• public share pages at /s/:token
• password-protected and expiring shares
• shared folder browsing with child-file download and thumbnail access inside the shared tree
• profile, avatar upload / Gravatar, and user preference APIs
• WebDAV accounts with independent passwords, root-folder restriction, and DeltaV subset support

Operations

• health endpoints: /health, /health/ready, optional /health/memory, /health/metrics
• runtime config stored in system_config
• admin overview, config schema, and policy connection testing endpoints
• audit logs for key actions
• Swagger UI in debug builds and static OpenAPI export via cargo test --features openapi --test generate_openapi
• hourly cleanup tasks for uploads, completed upload sessions, trash, locks, and audit log retention, plus 6-hour blob reconciliation

Documentation map

• Getting started
• Installation and deployment
• Developer docs
• Architecture
• Docker deployment
• API overview
• User guide

Development

Requirements

• Rust 1.91.1+
• Bun
• Node.js 24+ for the current Docker frontend build stage

Common commands

# Backend
cargo run
cargo check
cargo test
cargo test --features openapi --test generate_openapi

# Frontend
cd frontend-panel
bun install
bun run dev
bun run build
bun run check

Notes

• Type checking uses tsgo, not tsc
• Linting uses biome, not ESLint
• TypeScript enum is not allowed; use as const objects
• Type-only imports must use import type

Configuration

Static configuration is loaded with this priority:

Environment variables > config.toml > built-in defaults

Examples:

ASTER__SERVER__HOST=0.0.0.0
ASTER__SERVER__PORT=3000
ASTER__DATABASE__URL="postgres://aster:secret@127.0.0.1:5432/asterdrive"
ASTER__WEBDAV__PREFIX="/webdav"

Runtime configuration is stored in the database and can be updated from the admin API / admin panel.

Project structure

src/                    Rust backend
migration/              Sea-ORM migrations
frontend-panel/         React admin/file panel
docs/                   Deployment and end-user documentation
developer-docs/         API and architecture docs for contributors
tests/                  Integration tests

License

MIT - Copyright (c) 2026 AptS-1547