--- title: CloudFS - Shared POSIX Filesystem for AI Agents | Telnyx canonical: https://telnyx.com/products/cloudfs --- # CloudFS - Shared POSIX Filesystem for AI Agents | Telnyx **EDGE COMPUTE** # CloudFS Mount a POSIX filesystem on any host or container. Backed by Telnyx Cloud Storage, built for AI agents that need persistent, concurrent file access across runs. [Start Building](https://telnyx.com/sign-up)[CONTACT US](https://telnyx.com/contact-us) WHY TELNYX ## Build on one platform, not a stack of vendors. Compute, storage, database, inference, and telecom on one account, one API, one bill. CloudFS is the shared filesystem layer, connected through bindings, not API calls. * ### One platform, one bill Functions, KV, SQLDB, Object Storage, and Inference on a single account. CloudFS is the shared filesystem layer. No external storage vendor in the path. * ### One runtime, no glue code Mount CloudFS, query SQLDB, call inference, and send a message through the telecom API in the same request. No SDK per service, no glue code between layers. * ### Built for real-time agents Agents that need to call models, store state, and share files across runs. CloudFS gives them a persistent filesystem: clone repos, checkpoint state, no lost work. FEATURES ## A real filesystem, not a storage API Mount it with one command. Use it like a local directory. Every file persists in Telnyx Cloud Storage and is available to every client that mounts it. * POSIX semantics read, write, mkdir, rename, git init. Anything that works on a local directory works on CloudFS. No SDK to learn, no API to call. Your tools and your code already know how to use a filesystem. * Concurrent access by design Mount the same filesystem from many clients at once. A fleet of agents can read shared configs, write to a shared workspace, and collaborate on the same files. JuiceFS handles the coordination. * Mount anywhere Runs on any host or container that supports FUSE. Edge functions, bare metal, VMs, CI runners. If it can mount a filesystem, it can mount CloudFS. * Durable storage backend Every byte lives in Telnyx Cloud Storage. The same S3-compatible object storage that powers your edge functions. Survives container eviction, pod replacement, and infrastructure failure. * Open-source client CloudFS uses JuiceFS Community Edition (Apache-2.0). You run the client yourself. No proprietary agent, no vendor lock-in at the mount point. Telnyx provides the managed storage backend and the metadata database. * WebDAV for hosts without FUSE For environments where you cannot mount a filesystem, CloudFS exposes a WebDAV endpoint. Read and write files over HTTP from any language, any platform, any runtime. HOW IT WORKS ## Mount in three steps Create a filesystem over the API, mount it with the JuiceFS client, and use it like any local directory. The whole path runs end-to-end on Telnyx infrastructure. [Read the docs](https://developers.telnyx.com/docs/edge-compute/cloudfs) Create a filesystem ``` curl -X POST https://api.telnyx.com/v2/storage/cloudfs \ -H "Authorization: Bearer $TELNYX_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{"name": "agent-fs", "region": "us-east-1"}' ``` Mount it ``` export AWS_ACCESS_KEY_ID="$TELNYX_API_KEY" export AWS_SECRET_ACCESS_KEY="***" juicefs mount --no-usage-report --background --log /tmp/juicefs.log \ "$META_URL" /mnt/agentfs ``` Use it ``` cd /mnt/agentfs echo "hello cloudfs" > hello.txt cat hello.txt git init -q git add . && git commit -m "first commit" ``` Create a filesystemMount itUse it BINDINGS ## What CloudFS connects to on the platform. CloudFS is backed by Cloud Storage and mounts on any Edge Compute container. No credentials to manage, no external storage provider in the path. * [![Functions hero visual](https://us-central-1.telnyxcloudstorage.com/aimarketingmaterials/Product-Hero_Functions_2x---aafa44a8-5b26-4d84-902b-9059dc6a0db7.png)FunctionsMount a CloudFS filesystem inside a function container. Read config files, write outputs, share state across invocations. The filesystem persists between deployments.](https://telnyx.com/products/functions) * [![Stateful Actors hero visual](https://us-central-1.telnyxcloudstorage.com/aimarketingmaterials/statefulactor_hero---a8760bd3-f66c-428c-ab25-e2887f4990e8.png)Stateful ActorsActors can mount CloudFS for durable file access alongside their embedded SQL database. Checkpoints, working files, and shared documents that need to survive eviction.](https://telnyx.com/products/stateful-actors) * [![Cloud Storage hero visual](https://cms.telnyx.com/api/media/file/Storage_Hero_16x9@2x.webp?prefix=cms-media)Cloud StorageCloudFS is backed by Cloud Storage. Every file lives in an S3-compatible bucket in your Telnyx account. The same storage layer your functions use for object-level access.](https://telnyx.com/products/cloud-storage) * [![Inference hero visual](https://d2efw2akbx8gaf.cloudfront.net/https://dotcom-payload-assets-prod.s3.us-east-1.amazonaws.com/cms-media/LLM_Hero_16x9@2x.webp?width=1120&format=webp)InferenceMount model weights, prompt templates, or RAG indexes from CloudFS. Run inference on owned GPUs in the same facility. No external storage hop between your files and your model.](https://telnyx.com/products/inference) ## Sign up and start building. Get an API key, create a filesystem, and mount it from your first container in minutes. [SIGN UP](https://telnyx.com/sign-up)[TALK TO US](https://telnyx.com/contact-us) ## Sign up and start building. Get an API key, create a filesystem, and mount it from your first container in minutes. [SIGN UP](https://telnyx.com/sign-up)[TALK TO US](https://telnyx.com/contact-us) ## FAQ ### What is CloudFS? CloudFS is a POSIX filesystem you mount on any host or container, backed by Telnyx Cloud Storage. It behaves like a local directory but stores every byte durably in object storage. The same filesystem can be mounted by many clients at once, making it a shared persistent layer for AI agents. ### How is CloudFS different from Cloud Storage? ### Can multiple agents read and write to the same CloudFS at the same time? ### What client do I need to mount CloudFS? ### Is CloudFS production-ready? ### Can I use CloudFS without Edge Compute? ### What happens to my files if a container restarts? ### Can I access CloudFS without mounting it? [Start building](https://telnyx.com/sign-up)