SeaweedFS Blog

Engineering notes on distributed storage — new features, use cases, and optimization strategies from production clusters.

7 min read

Querying SeaweedFS Table Buckets with DuckDB

A SeaweedFS table bucket is an S3 bucket that’s also an Apache Iceberg warehouse, fronted by a built-in Iceberg REST catalog — no Hive Metastore, Nessie, or Glue to run. This is a complete, real transcript: start SeaweedFS, create and load a table with PyIceberg, then attach the catalog from DuckDB and run SQL. Every command and output block below was run end to end on one machine.

Read more →
9 min read

Conditional Writes Without a Compare-and-Swap Store

S3 conditional writes — If-None-Match, If-Match, etag preconditions, object lock — need a read-check-write that’s atomic across every gateway and filer. Instead of demanding compare-and-swap from each of SeaweedFS’s many metadata backends, or taking a distributed lock on every write, SeaweedFS routes each object’s writes to one owner filer that serializes them locally. Consistent on LevelDB through Cassandra, at the cost of at most one extra hop.

Read more →
9 min read

Sealing Directories You Still Write To

A frozen seal rejects every write — perfect for finished data, awkward for a directory that still takes the occasional straggler. Mutable seals keep most of the metadata savings while staying writable. Here’s how they work, what they cost — measured on a live cluster — and why you still shouldn’t seal everything this way.

Read more →
10 min read

From Empty Server to Kernel-Mounted SeaweedFS, Step by Step

A complete, real transcript: install the seaweed-vfs kernel module and daemon on a bare Debian box, mount a SeaweedFS filer with mount -t seaweedvfs, run SQLite and a compiler on it, watch the page cache do its thing — and re-export the whole namespace over NFS with the stock Linux kernel server.

Read more →
7 min read

Undo for Your Storage: Data Recovery and Point-in-Time Recovery

Replication and erasure coding protect you from dying disks — not from a bad rm, a corrupting ETL job, or an AI agent rewriting the wrong prefix. SeaweedFS Enterprise gives every second in a retention window a working undo: find and restore deletes, or rewind a whole subtree to any instant, with a previewed plan before anything changes.

Read more →
11 min read

Sealed Directories: 18–58× Less Metadata for Cold Data

Most metadata in a large cluster describes files nobody has touched in months — yet it costs the same as metadata for hot files. Sealed directories pack a cold directory’s entries into compressed, volume-stored chunks, while every file stays readable in place.

Read more →