AtalayaLabs/OxiCloud

A fast self-hosted cloud for people who want files, calendars, contacts, and office editing without dragging a heavy stack behind them.

Documentation · Quick Start · Star OxiCloud · Request a Feature · Supported Clients · Project Status

If OxiCloud saves you setup time, RAM, or complexity, give it a star. If something is missing, ask for a feature or request a docs improvement.

OxiCloud is aimed at self-hosters, home labs, and small teams who want the useful parts of a cloud suite without the operational drag of a traditional PHP stack.

What pulls people in:

• Standard protocols first: WebDAV, CalDAV, and CardDAV are built in
• Useful product surface already there: files, previews, sharing, trash, search, favorites, and recent items
• Modern auth and admin basics: OIDC/SSO, quotas, roles, and shared links
• Better interoperability: native desktop and mobile clients work without custom sync tooling for basic access
• Lower deployment friction: Docker Compose, environment-based configuration, Helm chart, and Nix module

OxiCloud is not trying to mirror the full plugin ecosystem of Nextcloud. It is designed for a smaller stack, fast startup, and standards-based interoperability.

Requires Docker and Docker Compose.

git clone https://github.com/AtalayaLabs/OxiCloud.git
cd OxiCloud
cp example.env .env

# If users will access OxiCloud through a domain or reverse proxy,
# set OXICLOUD_BASE_URL in .env before the first login.
docker compose up -d

Open http://localhost:8086.

Binary releases (Linux musl amd64/arm64, macOS Intel/Apple Silicon) are attached to every tagged release on GitHub — the whole SPA + all operator subcommands + migrations bake into a single self-contained executable. See docs/install/binary.md for the download / verify / systemd walkthrough.

cargo binstall oxicloud works too once a release is out.

Requires Rust 1.93+ and PostgreSQL.

git clone https://github.com/AtalayaLabs/OxiCloud.git
cd OxiCloud
cp example.env .env

# If PostgreSQL runs on your host instead of Docker, update both
# OXICLOUD_DB_CONNECTION_STRING and DATABASE_URL to use localhost:5432.
cargo run

Deployment details: deployment guide · example.env

OxiCloud uses standard DAV protocols, so it works with native clients instead of requiring a custom sync stack for basic access.

Common clients that work well:

• macOS Finder
• Windows Explorer
• GNOME Files and KDE Dolphin
• Thunderbird
• Apple Calendar and Contacts
• DAVx5 on Android

Client setup guides: DAV client setup · WebDAV guide · CalDAV & CardDAV guide

OxiCloud is actively developed and already covers the core self-hosted cloud workflow.

Roadmap: TODO-LIST.md

If you want OxiCloud to get better faster, use the repo like a product feedback loop, not just a code dump.

• Give it a star if you want more people to discover the project: Star OxiCloud
• Propose missing functionality: feature request
• Point out confusing onboarding or weak docs: documentation request
• Report breakage or regressions: bug report
• Build it with us: CONTRIBUTING.md

The best feature ideas usually come from real deployment pain. If you hit friction, open an issue and describe the workflow you want.

OxiCloud follows a clean, hexagonal architecture so protocol handlers, business logic, and infrastructure stay separated.

• Backend: Rust + Axum
• Database: PostgreSQL
• Configuration: environment variables
• Default deployment: Docker Compose
• Additional packaging: Helm chart and Nix module

Architecture docs: internal architecture · caching architecture · database transactions · storage safety

Start with example.env. The most important settings are:

• OXICLOUD_BASE_URL for reverse proxies, domains, and external access
• OXICLOUD_DB_CONNECTION_STRING for PostgreSQL
• OXICLOUD_OIDC_ENABLED and related settings for SSO
• OXICLOUD_WOPI_ENABLED and discovery URL for office editing
• MIMALLOC_PURGE_DELAY=0 for lower idle RSS in constrained environments

Integration docs: OIDC setup · OIDC architecture · OIDC config examples · WOPI integration

• Docs site: AtalayaLabs.github.io/OxiCloud
• Deployment: docs/config/deployment.md
• Batch operations: docs/guide/batch-operations.md
• Search: docs/guide/search.md
• Thumbnails and transcoding: docs/guide/thumbnails-and-transcoding.md
• Deduplication: docs/guide/deduplication.md

cargo fmt --all --check
cargo clippy --all-features --all-targets -- -D warnings
cargo test --workspace

Contributions are welcome. Read CONTRIBUTING.md before opening a pull request and CODE_OF_CONDUCT.md for community expectations.

If you are not ready to code yet, starring the project and opening a precise feature request is still a meaningful contribution.

Contributors

OxiCloud is a community-driven project, and we appreciate all contributions. Check out the Contributors page to see the amazing people who have helped make OxiCloud better.

Star History

License

MIT. See LICENSE.

OxiCloud is a trademark of the OxiCloud project. All other trademarks are the property of their respective owners.