CottonFeatures
Features

Everything a file cloud should do. In the browser. Without plugins.

Previews, sharing, snapshots, WebDAV, dedup, streaming encryption — not bolt-ons, not marketplace items, not roadmap. Just there, in one focused self-hosted product.

Self-hosted file cloudRich previewsSnapshotsWebDAVSecurity postureDocker

Store efficiently

Files are split into content-addressed chunks, described by manifests, compressed before encryption, and written through a storage model that can reuse identical content without making every visible file a physical duplicate.

  • SHA-256 chunk identity anchors deduplication and integrity checks.
  • Inline compression runs before encrypted storage persistence.
  • Filesystem and S3-compatible backends can share the same logical object model.

Upload reliably

Large uploads should not become a special crisis path. Cotton uses chunk-first upload, worker hashing, parallel transfer, and missing-chunk retry so interruption changes the retry set instead of forcing a full restart.

  • Chunk count grows with file size; the memory shape stays predictable.
  • The server can validate uploaded chunk identity.
  • Browser and WebDAV writes land in the same storage pipeline.

Work in the browser

A file cloud should show what is inside the file. Cotton treats previews as product surface for documents, images, audio, video, text, Markdown, HEIC, SVG, and selected 3D model files.

  • Mobile PDF can stay in the app with selectable text when the source contains text.
  • Audio can show cover art, generated waveform fallback, playback, and synced text tracks.
  • Legacy video can use on-demand HLS where Cotton can safely generate it.

Share safely

Sharing is a lifecycle, not only a URL. Cotton can give recipients preview-aware share pages while users and operators keep expiry, single-use options, token cleanup, and notifications in the product flow.

  • Share pages are more useful than raw object links.
  • Expiring and single-use tokens reduce forever-link drift.
  • Native browser share hooks can make mobile sharing feel normal.

Recover normally

Recovery should be a product action. Versions, snapshots, trash, and restore flows are shaped around references so rollback does not have to become a giant copy job.

  • Snapshots can preserve layout state by reference.
  • File versions let users inspect, download, and restore previous content.
  • Cleanup stays tied to the reference graph instead of guessing from loose files.

Operate clearly

Self-hosting should not mean blind trust. Cotton exposes setup, quotas, storage pressure, admin security diagnostics, passkeys, sessions, WebDAV, database integrity signatures, and backup/restore posture as visible product concerns.

  • Admin checkup turns deployment posture into actionable signals.
  • Passkeys, TOTP, and session revoke reduce account-security guesswork.
  • Storage checks and pressure guards surface problems before they become surprises.

Feature proof

The feature set works because it is connected: previews, shares, snapshots, WebDAV, encryption, background jobs, integrity checks, and deployment diagnostics all point back to the same file-cloud model instead of being unrelated plugins around a folder.

When the job is file cloud

Cotton is built deeper for files: large uploads, duplicate data, rich browser previews, safer sharing, ordinary recovery, and clear operations. It is focused by design rather than trying to become every collaboration tool at once.

When breadth matters more

Choose a broader suite when calendars, contacts, office editing, chat, federation, or marketplace apps are the core requirement. Cotton is the better fit when the file cloud itself is the product.

Product outcomes

What Cotton keeps working after upload.

Cotton turns storage architecture into everyday product advantages: uploads stay retryable, repeated bytes stay cheap, previews stay in the app, links expire, recovery stays normal, and operations stay visible.

Product overviewOne surface for real folders, mixed previews, sharing, recovery, WebDAV, and admin posture.
Large uploads

Chunk-first upload verifies pieces early and retries only what is missing.

Repeated content

Content-addressed chunks let repeated bytes collapse to shared storage.

Browser previews

Documents, audio, video, images, text, and model files stay useful in the app.

Share lifecycle

Expiring shares, single-use options, notifications, and cleanup keep links intentional.

Normal recovery

Versions, snapshots, and trash make recovery a normal product action.

Visible operations

Security diagnostics, quotas, pressure guards, and integrity checks surface posture.

FAQ

Direct answers

Is Cotton just a storage engine?

No. The storage engine is the reason the product behaves better, but Cotton also includes a browser file surface, previews, shares, snapshots, versions, WebDAV, security diagnostics, setup, and operations workflows.

What should I try first in the demo?

Open mixed files rather than only clicking folders: PDF, audio, video, Markdown, image galleries, and model files show why previews and seekable storage matter in daily use.

Can Cotton replace every Nextcloud feature?

No. Cotton is a focused file cloud, not a full groupware suite. It is a better fit when files, large media, previews, sharing, recovery, WebDAV, and storage behavior are the main job.

Is the deployment meant for normal self-hosting?

Yes. The normal shape is one Cotton image plus PostgreSQL and persistent storage. Public deployments still need ordinary operator work such as TLS, backups, updates, and hardening.