How does OxiCloud store files on the server?

[uninvitedguest]

Curious to know if OxiFloud stores data in a flat file (a la Seafile, Pydio Cells, etc) or in directories (a la Nextcloud).

Thanks.

[DioCrafts]

Sorry for the late reply, @uninvitedguest.

Short answer: OxiCloud stores files in directories, similar to Nextcloud. Your folder structure and filenames are preserved as-is on disk.

Each user gets a folder like storage/Mi Carpeta - username/, and everything inside mirrors the structure you see in the UI.

On top of that, there is an optional deduplication layer. When you upload a file, OxiCloud:

1. Writes it to the user's directory (standard filesystem path)
2. Stores a content-addressed copy in .blobs/<sha256_prefix>/<hash>.blob

The blob store runs in the background. It uses SHA-256 hashing with reference counting. If dedup fails for any reason, the upload still works -- it is non-blocking.

A few details worth knowing:

• Files under 4 KB skip deduplication entirely
• Blobs are sharded into 256 prefix directories for filesystem performance
• The primary read/write path always goes through the user's directory, not the blob store
• An ID mapping service translates between UUIDs (API layer) and filesystem paths

So in practice, if you browse the storage volume directly, you will find real files in a readable directory tree. The blob store exists alongside it for dedup purposes.

Hope that answers your question. Let me know if you want more detail on any part.

[uninvitedguest]

Great, thank you very much. I see activity on the project has picked up a ton, and knowing the file structure meets my needs I will definitely give it a spin.