Your data should not have to live on somebody else's computer to be useful.
Download • Docs • Discord • Build from source
Important
Spacedrive 2.0 Beta is planned for November 1, 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.
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. The beta will appear on the
releases page 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.
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 for the complete product boundary.
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.
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.
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.
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.
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.
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.
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.
The nightly release
carries sd and sd-daemon for macOS ARM64 (macos-aarch64) and Linux
x86-64 (linux-x86_64), each with a .sha256 file. Download both binaries
for your platform, verify them, and put them in a directory on your PATH:
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 installTo let sd keep itself on the latest nightly:
sd config set update.channel nightly
sd update --yes
sd update install-timerThe 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.
You need Rust 1.95 or newer (rust-toolchain.toml pins 1.97.1),
Bun 1.3.4 (the version package.json and CI pin; a newer
Bun rewrites bun.lockb), Node 20, and
just.
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 -- setupRun the daemon and your preferred client:
just dev-daemon # Rust daemon
just dev-desktop # Desktop client
just dev-server # Headless server and web interface
just dev-mobile # Mobile clientThe 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:
cargo run -p xtask -- setup --native-depsRun the checks before submitting a change:
just test
just checkSee the documentation for deployment, source, extension, and architecture guides.
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 for the full account.
- Read the Contributing Guide.
- Join the Discord community.
- Build a source adapter with the Archive and Adapters guide.
- Contribute to the shared interface system in SpaceUI.
Releases before 2026-03-24 were published under AGPL-3.0 and remain available under that license.

