# Tonbo Artifacts > A shared filesystem on S3, for AI agents, for any sandbox you already run. BYO bucket, multi-mount, daemonized FUSE. Customer-facing documentation. Each page is also available as raw markdown at https://artifacts.tonbo.io/docs/.md (e.g. https://artifacts.tonbo.io/docs/quickstart.md). For all docs concatenated, fetch https://artifacts.tonbo.io/llms-full.txt. ## Get started - [Overview](https://artifacts.tonbo.io/docs/overview.md): When an agent workload outgrows the local disk, and what Tonbo Artifacts does about it. - [Quickstart](https://artifacts.tonbo.io/docs/quickstart.md): Zero to a mounted workspace with an agent working in it, in five minutes: create and mount, point your agent at durable storage. ## Mounting - [Mount on Linux](https://artifacts.tonbo.io/docs/mount.md): Mount a Tonbo Artifacts workspace on a Linux host or sandbox VM, and unmount cleanly. - [Mount in a container](https://artifacts.tonbo.io/docs/mount-container.md): Run Tonbo Artifacts in Docker, Podman, or any OCI runtime, bind-mount from the host or run FUSE inside the container. - [Mount in Kubernetes](https://artifacts.tonbo.io/docs/kubernetes.md): Mount Tonbo Artifacts inside a Kubernetes pod on EKS, GKE, AKS, or kind. ## Guides - [Persist agent memory across runs](https://artifacts.tonbo.io/docs/agent-memory.md): Give an agent in a disposable sandbox a memory that survives: mount at boot, a directory contract the agent follows, and notes the next run can trust. - [Share files across machines](https://artifacts.tonbo.io/docs/multi-mount.md): Mount one workspace from several machines at once: when you need it, what each machine sees, and the write patterns that stay collision-free. - [Fan out agents over one dataset](https://artifacts.tonbo.io/docs/fan-out-agents.md): Run many agents on separate machines against one corpus: a work queue they claim from without double-processing, collision-free outputs, and a gather step. ## Concepts - [Workspaces](https://artifacts.tonbo.io/docs/workspaces.md): What a workspace is, how it's named and addressed, and the create / list / delete lifecycle with what each step actually does. - [Concurrent writes](https://artifacts.tonbo.io/docs/consistency.md): What happens when several machines or agents write one workspace at once: what readers see, when same-file writes collide, and how to publish results readers can trust. - [File locks and coordination](https://artifacts.tonbo.io/docs/file-locks-coordination.md): Cross-machine mutual exclusion for agent fleets: flock that works between machines, claim-by-rename for work queues, and when you don't need a lock at all. ## Delegated access - [Quickstart for platform users](https://artifacts.tonbo.io/docs/platform-quickstart.md): Provision isolated storage for your customers' runtimes end to end: tenant, grant, signed mount ticket, inject, mount, revoke. - [Multi-tenancy model](https://artifacts.tonbo.io/docs/tenancy-model.md): How Artifacts models a platform that provisions isolated storage for its own customers: root user, tenant, runtime, workspace, access grant, and mount ticket. - [Tenants and grants](https://artifacts.tonbo.io/docs/tenants-grants.md): Explicit tenant and grant management for platform backends: pre-create tenants, tenant-wide vs runtime-scoped grants, authorize without issuing, and revoke. - [Temporary mount credentials](https://artifacts.tonbo.io/docs/identity-access.md): Hand a runtime a short-lived mount ticket instead of your API key: issuing, narrowing scope, revocation, and what a ticket can never do. ## Setup - [Install the CLI](https://artifacts.tonbo.io/docs/install.md): One-liner installer for the Tonbo Artifacts client. - [Log in](https://artifacts.tonbo.io/docs/login.md): Sign in to the CLI with GitHub or Google, or use an API key for headless hosts. - [Bring your own bucket](https://artifacts.tonbo.io/docs/storage-credentials.md): Point a workspace at your own S3 bucket; credentials stay on the mounting host. - [API keys](https://artifacts.tonbo.io/docs/service-tokens.md): Long-lived API keys for headless agents and CI pipelines. - [Import data](https://artifacts.tonbo.io/docs/import-data.md): Move existing data into a Tonbo Artifacts workspace from a Mac folder, an S3 bucket, or local disk. ## Reference - [CLI reference](https://artifacts.tonbo.io/docs/cli.md): Every Tonbo Artifacts subcommand and flag. - [Error codes](https://artifacts.tonbo.io/docs/error-codes.md): API error responses, with hints for what to do next. - [Troubleshooting](https://artifacts.tonbo.io/docs/troubleshooting.md): Common errors during install, mount, and import, and how to clear them. ## How it works - [Architecture](https://artifacts.tonbo.io/docs/architecture.md): Tonbo Artifacts splits into three planes that fail independently. Knowing the model makes the failure behavior easy to reason about. - [Performance](https://artifacts.tonbo.io/docs/performance.md): The latency tiers that govern a Tonbo Artifacts mount, and why metadata-heavy agent workloads run an order of magnitude faster on this architecture. - [What's in your bucket](https://artifacts.tonbo.io/docs/storage-layout.md): What Tonbo Artifacts writes into a BYO bucket, what never appears there, and how to estimate object counts for a security or cost review.