# mountOS

> A cross-platform, forkable, time-traveling distributed filesystem over object storage.

mountOS mounts S3 and other object storage as a POSIX-compliant filesystem on macOS, Linux, Windows, and Kubernetes. It is self-hosted and distributed. Volumes also serve S3 and WebHDFS APIs and keep forks, time travel, and version history. A single deployment is free up to 10 TiB.

This file helps AI agents discover, understand, deploy, and get support for mountOS. Each link below points to a single self-contained topic. The concatenated corpus is at https://mountos.io/ai/llms-full.txt.

## Docs

- [Overview](https://mountos.io/ai/topics/overview.md): What mountOS is, a self-hosted POSIX filesystem that mounts S3 and other object storage on macOS, Linux, Windows, and Kubernetes
- [Product](https://mountos.io/ai/topics/product.md): One-page pitch for a self-hosted POSIX filesystem over object storage, who it is for, headline capabilities, and pricing at a glance
- [Architecture](https://mountos.io/ai/topics/architecture.md): The public architecture of mountOS: HUB, regions, services, clients, and storage
- [Components](https://mountos.io/ai/topics/components.md): The mountOS server services, clients, storage options, SDKs, and administration tools
- [Deployment](https://mountos.io/ai/topics/deployment.md): How to deploy a self-hosted mountOS suite from official binaries (mountos.sh/install). Covers the service fleet, external dependencies, the network and HA model, the bring-up order, and the shipped client-side assets (CSI, systemd, fstab)
- [Configuration and Environment](https://mountos.io/ai/topics/configuration.md): Configuration surface for mountOS server components, build-time identity, and the mountos client flags, grouped by component with verified defaults
- [Database and Schema](https://mountos.io/ai/topics/database-schema.md): The database requirements for mountOS deployments
- [Vaults and Secrets](https://mountos.io/ai/topics/secrets.md): Configure the external secret store used by mountOS services
- [Download and Install](https://mountos.io/ai/topics/download-install.md): Public download and install guide covering installer scripts, packages, artifact layout, and source builds
- [Support and Compatibility](https://mountos.io/ai/topics/support.md): How to obtain mountOS via the public installer, its versioning and release matrix, and protocol/S3/WebHDFS compatibility expectations
- [Getting Started (Build a System)](https://mountos.io/ai/topics/getting-started.md): End-to-end setup from nothing to a mounted volume, standing up the HUB, provisioning with the admin SDK, creating a region and its default metadata cluster, deploying the in-region services, and creating volumes and access keys
- [Admin SDK and API](https://mountos.io/ai/topics/admin-sdk.md): The open connector to a running deployment's HUB, Ed25519-signed Admin API access through TypeScript, Go, and Rust packages or REST, with the response envelope, pagination, error model, and client generation from api.yaml
- [Change Events](https://mountos.io/ai/topics/change-events.md): Per-volume ordered change-event feed (create, delete, modify, rename) for general volumes, enabled by eventLogRetentionPeriod, read with mountos event as a stdout stream or a local HMAC-authenticated REST API, with capture, pagination, and consumer semantics
- [Troubleshooting](https://mountos.io/ai/topics/troubleshooting.md): Diagnose with the built-in tooling, the mountos check command (per-platform backend verification with printed fixes), dashboards, the HUB alerts view, and a symptom-to-fix log reference for registration refusals, boot exits (env, license, vault), db install/migrate, client mount and discovery, gateway rejections, and change-event auth
- [Bulk and Streaming Sessions](https://mountos.io/ai/topics/bulk-streaming-sessions.md): Bulk upload (alias push), bulk download (alias pull), and continuous HLS sink (alias record), each a resumable, daemonized job with its own status/cancel and a live entry in the admin Sessions view

## Resources

- [Agent skill](https://mountos.io/skill.md): drop-in instructions for an AI agent (read this, then act)
- [Download](https://mountos.sh/install): release artifacts and install instructions
- [Support](https://mountos.io/docs/support): how to get help
- [Full corpus](https://mountos.io/ai/llms-full.txt): every topic concatenated