# Alternate Futures Docs

> Documentation hub for Alternate Futures products. Alternate Clouds is the decentralized cloud platform: deploy containers, AI agents, GPU and confidential workloads from the web app, the acc CLI, or the SDK.

Alternate Clouds is the Alternate Futures cloud platform. It deploys containers, AI agents, GPU workloads, and confidential (TEE) services on decentralized infrastructure from the web app, the acc CLI, or the TypeScript SDK.

- Docs index for agents: https://docs.alternatefutures.ai/llms.txt
- Every page in one file: https://docs.alternatefutures.ai/llms-full.txt
- Any page as Markdown: https://docs.alternatefutures.ai/llms.mdx/<path>/content.md (CLI reference: https://docs.alternatefutures.ai/llms.mdx/cli/commands/content.md)
- Agent guide: https://docs.alternatefutures.ai/ai-agents
- Web app: https://clouds.alternatefutures.ai (sign in with email or an Ethereum wallet; 14-day trial, no card)
- CLI: npm install -g @alternatefutures/acc && acc login. Command groups: projects, services, deployments, regions, templates, ssh, cp, attest, chat, billing, pat. Any command accepts --help.
- Non-interactive use: export AF_TOKEN (from acc pat create) and AF_PROJECT_ID, add -y to skip prompts, run acc whoami --json as a pre-flight check.
- Agent skills plugin for Claude Code, Cursor, and Codex: https://github.com/alternatefutures/alternate-clouds-skills
- Pages in the Legacy section describe the retired af CLI. Those commands do not exist in acc.

## Pages

- **Alternate Futures**
- [Overview](/): Documentation hub for Alternate Futures products. Start with Alternate Clouds, the decentralized cloud platform.
- [Brand guide](/brand-guide)
- [Changelog](/changelog): Changelog for the Alternate Futures platform, CLI, SDK, and infrastructure.

- **Alternate Clouds**

- **Start here**
- [What is Alternate Clouds?](/guides): A plain-language overview of Alternate Clouds: what it runs, the three ways to use it, and how billing works.
- [Quick start](/guides/quickstart): Deploy your first service to decentralized infrastructure with the acc CLI in minutes.
- [Sign in and accounts](/guides/authentication): Sign in to Alternate Clouds with email or an Ethereum wallet, and authenticate the CLI and SDK with personal access tokens.
- [Web app overview](/guides/dashboard): What each part of the Alternate Clouds web app does: Overview, Projects, Deployments, Members, Billing, Settings, Deploy, and Account settings.
- [Accounts, organizations, and projects](/guides/account-model): How an Alternate Clouds account is organized: organizations own billing and members, projects group services, and every service has deployments.
- [How billing works](/guides/how-billing-works): Why Alternate Clouds bills a subscription plus prepaid credits, what the trial includes, how usage is metered, and what happens when credits run low.
- [Docs for AI agents](/ai-agents): How AI agents and LLM tools should read these docs and operate Alternate Clouds: llms.txt, Markdown endpoints, the Copy for AI button, the agent plugin, and the non-interactive CLI contract.

- **Guides**
- [Manage projects](/guides/projects): Create, switch, rename, and delete projects with the acc CLI or the web app, point CI and agents at a project, and invite people to it.
- [Manage billing and credits](/guides/billing): Check your balance, top up credits by card or stablecoin, choose a plan, set spend controls on a service, and get suspended services running again.
- [Custom domains](/guides/custom-domains): Bring your own domain from any registrar (GoDaddy, Namecheap, Cloudflare, etc.) and point it to your Alternate Clouds services.
- [Create and use access tokens](/guides/api-keys): Create a personal access token with acc pat, use it from CI, scripts, agents, and the SDK, and revoke it when it is no longer needed.
- [Troubleshoot common problems](/troubleshooting): Fixes for the problems people hit most with the acc CLI, sign-in, stuck or failed deployments, suspended services, and billing on Alternate Clouds.
- [Glossary](/guides/glossary): Definitions of the terms used across the Alternate Clouds docs, CLI, and web app, from access token to trusted execution environment.

- **Reference**
- CLI (acc): The acc command line interface: install, sign in, and the full command reference.
  - [CLI overview](/cli): acc is the Alternate Clouds command line interface for deploying and managing services on decentralized infrastructure.
  - [Install the CLI](/cli/installation): Install the acc command line interface with npm, verify it, and authenticate.
  - [Command reference](/cli/commands): Complete reference for every acc command and flag, generated from the CLI source.
- SDK (TypeScript): The @alternatefutures/sdk package for programmatic access.
  - [SDK overview](/sdk): The Alternate Futures SDK provides a JavaScript/TypeScript library for programmatic access to the platform. Build decentralized applications with IPFS storage,
  - [Install the SDK](/sdk/installation): Complete guide to installing and configuring the Alternate Futures SDK.
  - [SDK quick start](/sdk/quickstart): Get started with the Alternate Futures SDK in under 5 minutes.
  - [SDK API reference](/sdk/api): TypeScript SDK API reference, auto-generated from @alternatefutures/sdk@0.2.3.

- **Self-hosting**
- [Decentralized container registry](/guides/decentralized-registry): Run your own fully decentralized container registry on Akash with IPFS storage - no Docker Hub, no third parties, standard docker push/pull.
- [Registry architecture](/guides/registry-architecture): Deep dive into the technical architecture of the decentralized container registry.
- [Deploy the registry](/guides/registry-deployment): This guide walks you through deploying your own OpenRegistry + IPFS stack on Akash Network.

- **Archive**
- Retired af CLI guides: Guides written for the retired af CLI and its sites, storage, and functions workflow. Kept for reference; these commands do not exist in acc.
  - [Retired af CLI guides](/legacy): What happened to the af CLI, which guides in this section still apply, and where the current equivalents live.
  - [Deploying sites](/guides/sites): Deploy static sites to decentralized storage networks (IPFS, Filecoin, Arweave).
  - [Cloud functions](/guides/functions): Deploy serverless edge functions on decentralized infrastructure with Alternate Futures Functions.
  - [Managing AI agents](/guides/agents): The web interface for managing agents is currently under development. Use the CLI or SDK to deploy and manage AI agents.
  - [Storage management](/guides/storage): The web interface for storage management is currently in development. Use the CLI or SDK to manage your decentralized storage.
  - [Observability and APM](/guides/observability): Monitor your applications with distributed tracing, metrics, and logging. The Alternate Futures Observability platform provides full APM (Application Performanc
  - [Applications](/guides/applications): Applications in Alternate Futures allow you to create OAuth applications and manage whitelisted domains for CORS and authentication purposes.
  - [Private gateways](/guides/gateways): Create dedicated IPFS gateways with custom domains for fast, reliable access to your decentralized content.
  - [IPNS (InterPlanetary Name System)](/guides/ipns): Use IPNS to create mutable pointers to your IPFS content, enabling dynamic updates without changing URLs.
  - [ENS (Ethereum Name Service)](/guides/ens): Connect your Alternate Futures sites to Ethereum Name Service (ENS) domains for decentralized, human-readable URLs.
  - [CI/CD integration](/guides/cicd): Automate deployments with continuous integration and delivery pipelines.
  - [Best practices](/guides/best-practices): Optimize your Alternate Futures deployments for performance, cost, and reliability.
  - [Deploy a Next.js app](/guides/deploy-nextjs): Step-by-step guide to deploying a Next.js application to decentralized infrastructure with Alternate Futures.
  - [Deploy a React app](/guides/deploy-react): Step-by-step guide to deploying a React application (Vite or Create React App) to decentralized infrastructure with Alternate Futures.
  - [Deploy an Astro Site](/guides/deploy-astro): Step-by-step guide to deploying an Astro site to decentralized infrastructure with Alternate Futures.
  - [Migrate from Fleek](/guides/migrate-from-fleek): Step-by-step guide to migrate your sites, IPFS content, domains, and CI/CD from Fleek to Alternate Futures.
  - [Migrate from Netlify](/guides/migrate-from-netlify): Move your static sites, serverless functions, and custom domains from Netlify to Alternate Futures for decentralized hosting.
  - [Migrate from Spheron](/guides/migrate-from-spheron): Step-by-step guide to migrate your sites, storage, and deployments from Spheron to Alternate Futures decentralized hosting.
  - [Migrate from Vercel](/guides/migrate-from-vercel): Move your static sites and serverless functions from Vercel to Alternate Futures for decentralized hosting with IPFS and Arweave.