Skip to content

jax-protocol/jax-fs

Repository files navigation

JaxBucket

Crates.io Documentation CI License: MIT

End-to-End Encrypted Storage Buckets with Peer-to-Peer Synchronization

SECURITY DISCLAIMER

This software has NOT been audited by security professionals and is NOT production-ready.

JaxBucket is an experimental project built for learning and demonstration purposes. The cryptographic implementation and protocol design have not undergone formal security review. Do not use this software to protect sensitive, confidential, or production data.

Use at your own risk. The authors assume no liability for data loss, security breaches, or other issues arising from the use of this software.

Desktop App

Download the latest Jax Desktop:

Or browse all releases.

Overview

JaxBucket is a local-first, encrypted storage system built on Iroh. It provides content-addressed, encrypted file storage with automatic peer-to-peer synchronization between authorized devices.

Features

  • End-to-End Encryption: All files encrypted with ChaCha20-Poly1305
  • P2P Sync: Automatic synchronization via Iroh's networking stack
  • Content-Addressed: Files stored as immutable, hash-linked DAGs
  • Cryptographic Access Control: ECDH + AES Key Wrap for secure multi-device access
  • Local-First: Works offline, syncs when connected

Downloads

Pre-built desktop binaries are available on the GitHub Releases page:

Platform File FUSE Mount Support
macOS (Apple Silicon) Jax_*_aarch64.dmg No
macOS (Apple Silicon + FUSE) Jax_*_aarch64_fuse.dmg Yes (requires macFUSE)
Linux (Debian/Ubuntu) jax-desktop_*_amd64.deb No
Linux (portable) jax-desktop_*_amd64.AppImage No

The _fuse variant enables mounting buckets as local filesystem directories. See the Installation Guide for details.

Quick Start

# Install (or update) the CLI
curl -fsSL https://raw.githubusercontent.com/jax-protocol/jax-fs/main/install.sh | sh

# Or install via cargo
cargo install jax-daemon

jax init
jax daemon
jax bucket create my-bucket
jax bucket add <bucket-id> ./file.txt
jax bucket ls <bucket-id>

Crates

Crate Description
jax-daemon CLI and daemon binary
jax-common Core library (crypto, mount, peer)
jax-desktop Tauri desktop app

Documentation

Contributing

See agents/CONTRIBUTING.md for guidelines.

License

MIT - see LICENSE

Built With

  • Iroh - P2P networking
  • Rust - Systems programming
  • DAG-CBOR - Content-addressed serialization

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors