---
title: "vxs3 formats"
image: "https://docs.virdx.dev/img/virdx-social-card.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.virdx.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# vxs3 formats

{/* Vendored from mono/packages/vxs3/SUPPORTED_FORMATS.md @ ccb88febb15ad11c7c8848984755b3778252dac8 by scripts/sync-docs.sh. Do not edit here. */}

| File format | Storage strategy | Upload | Download |
| --- | --- | --- | --- |
| Generic files and ordinary directories (including opaque NIfTI/TIFF) | vxs3 tar shards + parquet manifest | Local `pack()` then `publish_bundle()` with `S3Destination` or an application adapter | `open_bundle()` then `Bundle.download()`; local `unpack()`; plain objects through `download()` |
| Zarr v2/v3 in bundles | Immutable tar members; preserves original bytes and layout | `pack()` then `publish_bundle()`, or SDK `bundles.upload()`; no automatic optimisation | `BundleStore` for diskless Zarr reads; `Bundle.download()` for exact restoration |
| Native Zarr v3 | Native storage/sharding | `upload_zarr()` / `optimize_zarr()` with `S3Destination` (direct S3/Ceph); fresh output only | `download_zarr()` with `S3Source`; sources and destinations can be mixed |
| Zarr v2 | Supported lossless pipelines migrate to native v3 on upload/optimisation | Same functions/backends; unsupported migrations fail explicitly; `optimize_local_zarr()` also works offline | Same download functions/backends; existing v2 store preserved unchanged |

Source: https://docs.virdx.dev/vx/cluster/vxs3-formats/index.mdx
