<p align="center">
<img src=".github/logo.png" alt="Spacedrive" width="120" height="120" />
</p>
<h1 align="center">Spacedrive</h1>
<p align="center">
<strong>Your data should not have to live on somebody else's computer to be useful.</strong>
</p>
<p align="center">
<a href="https://www.apache.org/licenses/LICENSE-2.0">
<img src="https://img.shields.io/static/v1?label=License&message=Apache-2.0&color=000" alt="Apache-2.0 license" />
</a>
<a href="https://github.com/spacedriveapp/spacedrive">
<img src="https://img.shields.io/static/v1?label=Core&message=Rust%20%2B%20TypeScript&color=DEA584" alt="Rust and TypeScript" />
</a>
<a href="https://discord.gg/gTaF2Z44f5">
<img src="https://img.shields.io/discord/949090953497567312?label=Discord&color=5865F2" alt="Spacedrive Discord" />
</a>
</p>
<p align="center">
<a href="https://github.com/spacedriveapp/spacedrive/releases"><strong>Download</strong></a> •
<a href="https://docs.spacedrive.com">Docs</a> •
<a href="https://discord.gg/gTaF2Z44f5">Discord</a> •
<a href="#build-from-source">Build from source</a>
</p>
---
> [!IMPORTANT]
> **Spacedrive 2.0 Beta is planned for November 15, 2026.**
>
> Beta commits to Spacedrive's data model and to preserving your library as
> it evolves. The release makes self-owned storage practical across
> your devices. It brings portable source indexes, private remote access, mounts, history,
> extensions, and one API for people and software.
>
> Nightly CLI and daemon builds are available now from the
> [nightly release](https://github.com/spacedriveapp/spacedrive/releases/tag/nightly).
> They are unsigned, move with every push to `main`, and can break, so keep
> backups of any library you point them at. See
> [Install a nightly](#install-a-nightly). The beta will appear on the
> [releases page](https://github.com/spacedriveapp/spacedrive/releases) when
> it ships.
Spacedrive is open personal data infrastructure. It turns the storage you
control into one private filesystem across your devices, drives, servers, and
the clouds you choose.
Bring your data home without giving up search, protection, intelligence,
sharing, or access from anywhere. No hosted account, no vendor control plane,
no telemetry.
<p align="center">
<img src="docs/public/SDGridView.webp" alt="Spacedrive browsing files across devices and locations" />
</p>
## Own where your data lives
Cloud services made it feel normal for your files to live on someone else's
computer. Personal files
and behavioral data piled up on infrastructure whose security, policies, and
future you do not control. Automated attacks increase
the scale of that exposure. AI increases the value of accumulated data for
training, inference, and profiling.
Owning the drive is the easy part. You still need to find files, reach them
from another device, know what is backed up, recover earlier states, share on
your terms, and notice when something changes.
Spacedrive does all of that while you decide where the bytes and metadata
live. Local disks, removable media, NAS datasets, private servers, and
offline archives are first-class homes. Cloud services remain optional sources
and destinations.
Read the [Product Direction](docs/core/product-direction.mdx) for the complete
product boundary.
## One filesystem, every source
A source can be a folder, a complete drive, a dataset on your NAS, another
Spacedrive node, a cloud bucket, or an external service. Every source uses the
same record shape and the same operations.
Each source has a portable store with two kinds of knowledge: a generation
that can be refreshed while the origin is available, and durable assertions
that cannot be reconstructed from the files alone. Disconnect a drive and its
catalog remains searchable. Move a source to another machine and its metadata
can travel with it.
- **A live index.** Watchers keep names, sizes, timestamps, and content state
current, so opening a folder never rescans the disk.
- **Search across boundaries.** One search runs across local, remote, cloud,
and adapter sources.
- **Stable identity.** Records survive moves. BLAKE3 content identities connect
copies of the same bytes across sources and devices.
- **Fast duplicate detection.** Sampled hashes find candidates quickly. Full-byte
verification confirms equality before destructive cleanup.
- **History that stays useful.** Freeze a source at a point in time, browse an
offline snapshot, and inspect which operation changed it.
- **Provider exit.** Move data away from a service without losing the
organization, tags, history, and knowledge built around it.
## Protection is part of the filesystem
Keeping files safe is filesystem work.
- Track integrity, redundancy, backup state, capacity, and unexpected changes.
- Distinguish independent copies using physical drives, pools, and failure
domains.
- Keep an inventory of drives that are offline, archived, lost, or retired.
- Preserve unreadable records with their error instead of omitting them.
- Run indexing, metadata extraction, previews, and search on infrastructure you
control by default.
- Name every external recipient before file content or derived metadata
leaves your devices.
An index snapshot preserves evidence about the filesystem. Provider versions
and backups preserve the bytes. Spacedrive connects the two so you can
understand what existed, where it lived, and how to recover it.
## See every change before it happens
The everyday threat to your files is an operation: a copy that overwrites the
wrong folder, a cleanup that deletes the last copy, a merge that lands
somewhere unintended. A durable filesystem protects your files from its own
operations.
Every operation that changes files answers two questions before it runs.
Validation answers whether it may run and how: permissions, capacity, safety
rules, and the exact strategy, enforced by the daemon rather than the dialog.
Preview answers what will exist afterward, projected from the index without
touching a file.
- **Browse the result before it exists.** A preview serves the same listings
as the present filesystem, so you walk the outcome folder by folder before
a byte moves.
- **Plan against offline storage.** The index answers for a drive sitting in
a drawer, so you can prepare a merge before you plug anything in.
- **Get warnings only an indexed filesystem can give.** Three of these files
are the last copy of their content anywhere in your library.
- **Skip duplicates on proof.** A file is treated as a copy only after
full-byte verification, never on a sampled hash.
- **Trust the execution.** The daemon re-validates at dispatch, applies the
same policy against the live filesystem, and reports any divergence from
the plan.
## Access anything from anywhere
Pair Spacedrive nodes to browse and operate their authorized sources through
the same interface. A live node serves queries, snapshots, byte ranges, jobs,
and logs. Other nodes can cache projections and content without claiming
authority over the source.
Share a source or subtree with another person, device, or agent without merging
libraries. The host decides what the recipient can see and do. The grant stays
visible and revocable, while the recipient sees the shared data beside their
own sources.
Mount any source or subtree into macOS, Windows, or Linux. Files stream on
demand from a local disk, another device, or a cloud provider through one byte
plane. Range reads power mounts, transfers, previews, media playback, and video
scrubbing without copying the whole file first.
Peer connections use Iroh and QUIC with end-to-end encryption. Devices connect
directly when they can and fall back to relays when they must.
## One API for people and software
The desktop app, web interface, mobile clients, CLI, generated SDKs, skills, and
MCP server all call the same registered operations. A copy has the same input,
progress, conflicts, and result whether a person clicks it or software invokes
it.
- Operations return structured data and stable identifiers.
- Validate, preview, and execute are the same three verbs for every
operation and every client.
- Long-running work becomes a durable job with progress, cancellation, restart
recovery, and logs.
- Remote clients can inspect the same job state through an authorized session.
- Capabilities are explicit, scoped, visible, and revocable.
Spacedrive does not bundle an agent or choose a model for you. Use the CLI,
skill, SDK, or MCP server with the agent you trust. Your agent gains a consistent
filesystem interface without becoming the owner of your data. An agent
validates first, shows you the plan, and commits the exact input it
previewed. That is what makes destructive file operations safe to delegate.
## Extend the filesystem
The default installation stays small. Extensions add specialized support only
when you need it.
An extension can contribute:
- A source adapter or storage backend.
- File recognition through extensions, MIME types, UTTypes, magic bytes, and
provider metadata.
- Typed metadata and search fields.
- Preview renderers, thumbnails, proxies, video thumbstrips, and persistent
sidecars.
- Registered jobs, actions, menus, settings, and focused views.
Platform bridges can discover handlers already registered with macOS, Windows,
and Linux. Heavy codecs, provider SDKs, and models remain outside the default
binary. Extensions install from explicit packages and declare the access they
need.
## Architecture
```mermaid
flowchart TB
people[Desktop, web, mobile, CLI]
software[SDKs, skills, MCP]
operations[Typed operation registry]
daemon[Spacedrive daemon]
stores[Source stores, history, jobs]
local[Local drives and NAS]
remote[Remote Spacedrive nodes]
cloud[Cloud providers]
adapters[Adapters and extensions]
people --> operations
software --> operations
operations --> daemon
daemon --> stores
daemon --> local
daemon --> remote
daemon --> cloud
daemon --> adapters
```
The Rust daemon owns filesystem identity, indexing, operations, policy, and
durable work. Clients connect through JSON-RPC over local sockets or WebSockets.
Network protocols use Iroh and QUIC. OpenDAL provides cloud storage backends.
SQLite gives each source a portable store and FTS5 index.
Core operations are registered at compile time with type-safe inputs and
outputs. Specta generates the TypeScript and Swift clients from those Rust
types, so every interface shares one contract.
## Install a nightly
The [nightly release](https://github.com/spacedriveapp/spacedrive/releases/tag/nightly)
carries `sd` and `sd-daemon` for macOS ARM64 (`macos-aarch64`), Linux
x86-64 (`linux-x86_64`) and Windows x86-64 (`windows-x86_64`, as `.exe`
files), each with a `.sha256` file. macOS and Linux are the supported
platforms. Windows is a preview: the CLI and daemon build and pass their unit
tests there, but the file operation, source and drive acceptance suites have
not run on Windows, there is no desktop app, and `sd daemon install` does not
set up auto-start, so run `sd-daemon` yourself. Download both binaries for
your platform, verify them, and put them in a directory on your `PATH`:
```bash
shasum -a 256 -c sd-macos-aarch64.sha256 sd-daemon-macos-aarch64.sha256 # sha256sum -c on Linux
chmod +x sd-macos-aarch64 sd-daemon-macos-aarch64
mv sd-macos-aarch64 ~/.local/bin/sd
mv sd-daemon-macos-aarch64 ~/.local/bin/sd-daemon
sd daemon install
```
To let `sd` keep itself on the latest nightly:
```bash
sd config set update.channel nightly
sd update --yes
sd update install-timer
```
The binaries are not signed with a Developer ID. On macOS, a browser download
carries the quarantine attribute and Gatekeeper refuses to run it until you
remove it with `xattr -d com.apple.quarantine sd sd-daemon`. Nightly builds
follow `main` and can break or change schemas without migrations, so keep
backups of any library you point them at.
## Build from source
You need [Rust](https://rustup.rs/) 1.95 or newer (`rust-toolchain.toml` pins 1.97.1),
[Bun](https://bun.sh) 1.3.4 (the version `package.json` and CI pin; a newer
Bun rewrites `bun.lockb`), Node 20, and
[just](https://github.com/casey/just).
```bash
git clone https://github.com/spacedriveapp/spacedrive
cd spacedrive
# Installs system dependencies on macOS, Linux, or Windows.
./scripts/setup.sh # .\scripts\setup.ps1 on Windows
bun install
cargo run -p xtask -- setup
```
Run the daemon and your preferred client:
```bash
just dev-daemon # Rust daemon
just dev-desktop # Desktop client
just dev-server # Headless server and web interface
just dev-mobile # Mobile client
```
The `sd-ffmpeg` crate is a default workspace member and links the FFmpeg
development libraries installed on the host (`libavutil`, `libavformat`,
`libavcodec`, `libavfilter`, `libavdevice`, `libswscale`, `libswresample`) and
uses `libclang` to generate its bindings. `scripts/setup.sh` installs them
(`libav*-dev` and `libclang-dev` on Debian and Ubuntu, `ffmpeg` on Homebrew).
Without them the first `cargo build` fails in `ffmpeg-sys-next` with
`libavutil.pc not found`.
The default build can use FFmpeg installed on the host for video thumbnails and
thumbstrips. Install the native codec bundle only when developing code that
links the optional FFmpeg, libheif, or Pdfium libraries:
```bash
cargo run -p xtask -- setup --native-deps
```
Run the checks before submitting a change:
```bash
just test
just check
```
See the [documentation](https://docs.spacedrive.com) for deployment, source,
extension, and architecture guides.
## Project history
Spacedrive began in 2021 as one interface over files scattered across devices
and cloud accounts. The first public version proved the demand and exposed the
cost of carrying two file models, fragile transfers, and too much product in
the default build.
V2 rebuilds the project around sources, portable stores, durable jobs, and one
typed operation surface. Read the [project history](docs/overview/history.mdx)
for the full account.
## Contributing
- Read the [Contributing Guide](CONTRIBUTING.md).
- Join the [Discord community](https://discord.gg/gTaF2Z44f5).
- Build a source adapter with the
[Archive and Adapters guide](docs/archive/README.md).
- Contribute to the shared interface system in
[SpaceUI](https://github.com/spacedriveapp/spaceui).
## License
[Apache-2.0](LICENSE).
Releases before 2026-03-24 were published under AGPL-3.0 and remain available
under that license.