NextCloud was too slow on my home server. So I built OxiCloud: a file storage system written in Rust that runs on minimal hardware and stays out of your way.

You need Rust 1.70+, Cargo, and PostgreSQL 13+.

git clone https://github.com/DioCrafts/oxicloud.git
cd oxicloud

# Set up your database connection
echo "DATABASE_URL=postgres://username:password@localhost/oxicloud" > .env

# Build and run
cargo build --release
cargo run --bin migrate --features migrations
cargo run --release

Open http://localhost:8086 in your browser.

# Copy example environment file and customize
cp example.env .env
# Edit .env with your settings (optional - defaults work for quick testing)

docker compose up -d

That's it. The app runs on port 8086.

OxiCloud uses Clean Architecture with four layers:

┌─────────────────────────────────────────┐
│  Interfaces    │ API routes, handlers   │
├─────────────────────────────────────────┤
│  Application   │ Use cases, services    │
├─────────────────────────────────────────┤
│  Domain        │ Business logic         │
├─────────────────────────────────────────┤
│  Infrastructure│ Database, filesystem   │
└─────────────────────────────────────────┘

Each layer only talks to the one below it. You can swap out the database or add new API endpoints without touching business logic.

cargo build                 # Build
cargo run                   # Run locally
cargo test                  # Run tests
cargo clippy                # Lint
cargo fmt                   # Format

# For debugging
RUST_LOG=debug cargo run

• File upload, download, and organization
• Folder management with drag-and-drop
• Trash bin with restore functionality
• User authentication with JWT
• Personal folders per user
• File deduplication
• Write-behind cache for fast uploads
• Search across files and folders
• Favorites and recent files
• Responsive grid/list views

I'm working on these when I have time:

• File sharing via links
• WebDAV for desktop sync
• Basic versioning
• Mobile app improvements

Check TODO-LIST.md for the full list.

The project is early stage. There's plenty to improve.

Read CONTRIBUTING.md before submitting a PR. Follow the Code of Conduct.

MIT. See LICENSE.

Questions? Open an issue. Want to help? PRs welcome.