# InstaCloud Docs

- [Introduction](https://docs.instacloud.com/introduction.md): InstaCloud is the agent-native cloud: branchable Postgres, storage, and compute with one gated seam for credentials.
- [Quickstart](https://docs.instacloud.com/quickstart.md): Install the CLI, create a project, deploy, branch — in five minutes.
- [The basics](https://docs.instacloud.com/the-basics.md): The mental model: projects, branches, services, secrets, and the approval gate.
- [InstaCloud for agents](https://docs.instacloud.com/for-agents.md): Why the platform is shaped for coding agents, and what to install.
- [Best practices](https://docs.instacloud.com/best-practices.md): Patterns that keep projects cheap, safe, and easy to branch.
- [Production readiness checklist](https://docs.instacloud.com/production-checklist.md): What to verify before pointing real traffic at a service.
- [Agents overview](https://docs.instacloud.com/agents/overview.md): The `insta` skill, the MCP server, and the governance model for agents.
- [Set up your coding agent](https://docs.instacloud.com/agents/setup.md): One command installs the CLI, the skill, and the MCP server for every agent on the machine.
- [MCP server](https://docs.instacloud.com/agents/mcp-server.md): Connect any MCP client to InstaCloud.
- [Agent skills](https://docs.instacloud.com/agents/skills.md): The `insta` skill and project-level stack skills.
- [Claude Code](https://docs.instacloud.com/agents/claude-code.md): Use InstaCloud from Claude Code.
- [Cursor](https://docs.instacloud.com/agents/cursor.md): Use InstaCloud from Cursor.
- [Codex](https://docs.instacloud.com/agents/codex.md): Use InstaCloud from Codex.
- [OpenCode, Copilot, Factory Droid](https://docs.instacloud.com/agents/other-agents.md): Setup notes for the other supported agents.
- [One branch per task](https://docs.instacloud.com/agents/branch-per-task.md): Run agents in parallel, each in an isolated environment.
- [Human in the loop](https://docs.instacloud.com/agents/human-in-the-loop.md): Gate what agents can do; approve from CLI, MCP, or dashboard.
- [Credential audit hook](https://docs.instacloud.com/agents/observe.md): Detect credentials leaking through agent tool calls.
- [How InstaCloud works](https://docs.instacloud.com/platform/how-it-works.md): The pieces: control plane, insta-db, microVM compute, object storage, and the daemon you can self-host.
- [Compare to Railway](https://docs.instacloud.com/platform/compare/railway.md): Where InstaCloud and Railway overlap and where they differ.
- [Compare to Fly.io](https://docs.instacloud.com/platform/compare/fly.md): Where InstaCloud and Fly overlap and where they differ.
- [Migrate from Railway](https://docs.instacloud.com/platform/migrate/railway.md): Move services, databases, and variables from Railway.
- [Migrate from Fly.io](https://docs.instacloud.com/platform/migrate/fly.md): Move apps, Postgres, and secrets from Fly.
- [Plans](https://docs.instacloud.com/pricing/plans.md): Free, Pro, Team, and Enterprise — what each unlocks.
- [Understanding your bill](https://docs.instacloud.com/pricing/understanding-your-bill.md): The five usage dimensions and how they are metered.
- [Cost control](https://docs.instacloud.com/pricing/cost-control.md): Sleep to zero, right-size limits, delete branches.
- [Pricing FAQ](https://docs.instacloud.com/pricing/faq.md): Short answers about billing.
- [Projects](https://docs.instacloud.com/projects/overview.md): The unit of ownership: one Postgres, one bucket, any number of compute services.
- [Branches](https://docs.instacloud.com/projects/branches.md): A branch clones the database with data, the bucket, and every compute service.
- [Environments](https://docs.instacloud.com/projects/environments.md): Production, staging, and the local daemon: how the CLI targets each.
- [The manifest](https://docs.instacloud.com/projects/manifest.md): An agent-legible view of every branch, service, and URL.
- [Build & deploy](https://docs.instacloud.com/deploy/overview.md): From a directory, a Dockerfile, an image, or GitHub to a running service.
- [Services](https://docs.instacloud.com/deploy/services.md): Postgres, storage, and compute services; naming, groups, access.
- [Framework detection](https://docs.instacloud.com/deploy/builds/detection.md): How a source deploy picks a builder and a port.
- [Dockerfiles](https://docs.instacloud.com/deploy/builds/dockerfile.md): Deploy with your own Dockerfile.
- [Prebuilt images](https://docs.instacloud.com/deploy/builds/images.md): Deploy an image from a registry.
- [Monorepos](https://docs.instacloud.com/deploy/builds/monorepo.md): Deploy one app from `apps/`, `packages/`, or `services/`.
- [Ports and the PORT variable](https://docs.instacloud.com/deploy/deployments/ports.md): Listen on the right port, or run a worker with none.
- [Secrets and variables](https://docs.instacloud.com/deploy/deployments/secrets.md): Standard env vars scoped project → branch → service.
- [Regions](https://docs.instacloud.com/deploy/deployments/regions.md): Where compute and Postgres run.
- [WebSockets](https://docs.instacloud.com/deploy/deployments/websockets.md): Deploy a WebSocket service.
- [Deploy events](https://docs.instacloud.com/deploy/deployments/deploy-events.md): Follow a deploy and read its history.
- [Deploy from GitHub](https://docs.instacloud.com/deploy/github/overview.md): Connect the GitHub App and deploy on push.
- [Pull request environments](https://docs.instacloud.com/deploy/github/pull-request-environments.md): A branch environment per pull request.
- [No start command found](https://docs.instacloud.com/deploy/troubleshooting/no-start-command.md): Fix a build that cannot find how to start your app.
- [Application failed to respond](https://docs.instacloud.com/deploy/troubleshooting/failed-to-respond.md): The service is running but nothing answers.
- [Build failures](https://docs.instacloud.com/deploy/troubleshooting/build-failures.md): Reading build logs and common causes.
- [Postgres](https://docs.instacloud.com/postgres/overview.md): A real, isolated Postgres server per project that scales to zero and branches in seconds.
- [Connect](https://docs.instacloud.com/postgres/connect.md): Get a connection string and connect from your app, psql, or an ORM.
- [Branching a database](https://docs.instacloud.com/postgres/branching.md): How a branch copies the database and what that means for your data.
- [Scale to zero](https://docs.instacloud.com/postgres/scale-to-zero.md): Idle databases cost nothing; connections wake them.
- [Sizing and limits](https://docs.instacloud.com/postgres/sizing.md): vCPU, memory, storage, and how to grow them.
- [Databases and roles](https://docs.instacloud.com/postgres/databases-and-roles.md): Multiple databases per server, extra roles, password rotation.
- [Backups and restore](https://docs.instacloud.com/postgres/backups.md): Automatic backups to object storage; restore in place or to a copy.
- [Extensions](https://docs.instacloud.com/postgres/extensions.md): Available extensions and how to enable them.
- [Metrics and queries](https://docs.instacloud.com/postgres/observability.md): Metrics, active and slow queries, and logs.
- [Storage buckets](https://docs.instacloud.com/storage/overview.md): An S3-compatible bucket per branch, forked with the branch.
- [Bucket access](https://docs.instacloud.com/storage/access.md): Public and private buckets, scoped keys.
- [Uploading and serving](https://docs.instacloud.com/storage/objects.md): Use any S3 SDK or CLI; presigned uploads; the object browser.
- [Volumes](https://docs.instacloud.com/storage/volumes.md): One persistent `/data` volume per compute service.
- [Compute](https://docs.instacloud.com/compute/overview.md): Run any container in a microVM that sleeps when idle.
- [Sleep and wake](https://docs.instacloud.com/compute/sleep-and-wake.md): Idle services cost nothing; requests wake them in seconds.
- [Limits and scaling](https://docs.instacloud.com/compute/limits-and-scaling.md): Memory and CPU ceilings, instance counts, plan gates.
- [Workers](https://docs.instacloud.com/compute/workers.md): Long-running processes with no HTTP endpoint.
- [Networking](https://docs.instacloud.com/networking/overview.md): How traffic reaches a service: public HTTPS by hostname.
- [Custom domains](https://docs.instacloud.com/networking/custom-domains.md): Point your own hostname at a compute service.
- [SSL and certificates](https://docs.instacloud.com/networking/troubleshooting/ssl.md): Certificate not issued or browser warnings.
- [Logs](https://docs.instacloud.com/observability/logs.md): Runtime logs for compute and Postgres.
- [Metrics](https://docs.instacloud.com/observability/metrics.md): Resource metrics for compute and Postgres.
- [Events timeline](https://docs.instacloud.com/observability/events.md): Every resource and governance action, plus agent events.
- [Governance](https://docs.instacloud.com/governance/overview.md): Every sensitive action passes an allow / deny / approve gate.
- [Approvals](https://docs.instacloud.com/governance/approvals.md): Review, approve, and deny parked actions.
- [Organizations and members](https://docs.instacloud.com/governance/organizations.md): Orgs, roles, and invitations.
- [API tokens](https://docs.instacloud.com/governance/api-tokens.md): Scoped, revocable tokens for agents and CI.
- [Login methods](https://docs.instacloud.com/governance/login.md): Browser, OAuth, device code, and API key.
- [Self-hosting](https://docs.instacloud.com/self-hosting/overview.md): insta-oss: the open-source runtime that runs the same surface on your Docker.
- [Install](https://docs.instacloud.com/self-hosting/install.md): Start the daemon and connect the CLI.
- [Configuration](https://docs.instacloud.com/self-hosting/configuration.md): Ports, state directory, compute adapter, dashboard.
- [Architecture](https://docs.instacloud.com/self-hosting/architecture.md): CLI/MCP/dashboard → HTTP server → engine → adapter → Docker.
- [Adapters](https://docs.instacloud.com/self-hosting/adapters.md): Swappable providers for Postgres, storage, compute, and managed databases.
- [Managed databases](https://docs.instacloud.com/self-hosting/managed-databases.md): Private Redis, MySQL, and MongoDB containers per branch.
- [CLI & MCP compatibility](https://docs.instacloud.com/self-hosting/compatibility.md): Command-by-command behavior of insta-oss against the standard insta surface.
- [Frameworks](https://docs.instacloud.com/frameworks/overview.md): What to set for each detected stack.
- [Next.js](https://docs.instacloud.com/frameworks/nextjs.md): Deploy a Next.js app.
- [Nuxt](https://docs.instacloud.com/frameworks/nuxt.md): Deploy a Nuxt app.
- [Vite](https://docs.instacloud.com/frameworks/vite.md): Deploy a Vite app.
- [Remix](https://docs.instacloud.com/frameworks/remix.md): Deploy a Remix app.
- [Astro](https://docs.instacloud.com/frameworks/astro.md): Deploy a Astro app.
- [Express / Node](https://docs.instacloud.com/frameworks/express.md): Deploy a Express / Node app.
- [Django](https://docs.instacloud.com/frameworks/django.md): Deploy a Django app.
- [Flask](https://docs.instacloud.com/frameworks/flask.md): Deploy a Flask app.
- [FastAPI](https://docs.instacloud.com/frameworks/fastapi.md): Deploy a FastAPI app.
- [Deno](https://docs.instacloud.com/frameworks/deno.md): Deploy a Deno app.
- [Go](https://docs.instacloud.com/frameworks/go.md): Deploy a Go app.
- [Rust](https://docs.instacloud.com/frameworks/rust.md): Deploy a Rust app.
- [Java](https://docs.instacloud.com/frameworks/java.md): Deploy a Java app.
- [PHP](https://docs.instacloud.com/frameworks/php.md): Deploy a PHP app.
- [Ruby on Rails](https://docs.instacloud.com/frameworks/rails.md): Deploy a Ruby on Rails app.
- [Elixir / Phoenix](https://docs.instacloud.com/frameworks/elixir.md): Deploy a Elixir / Phoenix app.
- [Run agents in parallel](https://docs.instacloud.com/guides/parallel-agents.md): A branch per agent, a shared main, a merge at the end.
- [Use InstaCloud in CI](https://docs.instacloud.com/guides/ci.md): API tokens, linkless targeting, non-interactive deploys.
- [Lock down a production project](https://docs.instacloud.com/guides/lock-down-production.md): Policies, roles, and always-on for the branch that matters.
- [Rotate credentials](https://docs.instacloud.com/guides/rotate-credentials.md): Rotate the Postgres password and user secrets without downtime.
- [CLI](https://docs.instacloud.com/reference/cli/overview.md): Install, update, and the conventions every command follows.
- [insta login](https://docs.instacloud.com/reference/cli/login.md): Sign in with browser, OAuth, device code, or API key.
- [insta logout](https://docs.instacloud.com/reference/cli/logout.md): Clear local tokens.
- [insta status](https://docs.instacloud.com/reference/cli/status.md): Show login and linked project.
- [insta env](https://docs.instacloud.com/reference/cli/env.md): Show or switch the deployment environment.
- [insta org](https://docs.instacloud.com/reference/cli/org.md): List and create organizations.
- [insta project](https://docs.instacloud.com/reference/cli/project.md): Create, list, link, and delete projects.
- [insta branch](https://docs.instacloud.com/reference/cli/branch.md): Create, list, switch, merge, and delete branches.
- [insta services](https://docs.instacloud.com/reference/cli/services.md): Add, list, remove, rename, scale, and set access on services.
- [insta secrets](https://docs.instacloud.com/reference/cli/secrets.md): Fetch, list, set, unset, and inspect secrets.
- [insta run](https://docs.instacloud.com/reference/cli/run.md): Run a command with branch credentials injected.
- [insta deploy](https://docs.instacloud.com/reference/cli/deploy.md): Deploy a directory or image to a branch.
- [insta compute](https://docs.instacloud.com/reference/cli/compute.md): Domains, lifecycle, limits, always-on, volumes.
- [insta db](https://docs.instacloud.com/reference/cli/db.md): Postgres limits, stats, always-on, volume.
- [insta manifest](https://docs.instacloud.com/reference/cli/manifest.md): Show every branch environment and URL.
- [insta regions](https://docs.instacloud.com/reference/cli/regions.md): List available regions.
- [insta metrics](https://docs.instacloud.com/reference/cli/metrics.md): Query compute or database metrics.
- [insta logs](https://docs.instacloud.com/reference/cli/logs.md): Read runtime and deploy logs.
- [insta events](https://docs.instacloud.com/reference/cli/events.md): Audit and agent-event timeline.
- [insta usage](https://docs.instacloud.com/reference/cli/usage.md): Current billing cycle by dimension.
- [insta billing](https://docs.instacloud.com/reference/cli/billing.md): Billing overview, upgrade, portal.
- [insta policy](https://docs.instacloud.com/reference/cli/policy.md): Get and set governance policy.
- [insta approvals](https://docs.instacloud.com/reference/cli/approvals.md): List, approve, deny.
- [insta observe](https://docs.instacloud.com/reference/cli/observe.md): Credential-audit hook.
- [insta setup](https://docs.instacloud.com/reference/cli/setup.md): Install the agent skill.
- [insta mcp](https://docs.instacloud.com/reference/cli/mcp.md): Register the MCP server with an agent.
- [insta upgrade](https://docs.instacloud.com/reference/cli/upgrade.md): Update the CLI.
- [MCP tools](https://docs.instacloud.com/reference/mcp-tools.md): All `insta_*` tools by family, with gated-action semantics.
- [HTTP API](https://docs.instacloud.com/reference/api/overview.md): The REST API behind the CLI and MCP server.
- [Environment variables](https://docs.instacloud.com/reference/environment-variables.md): Every variable the CLI, installer, daemon, and your app see.
- [Gated actions](https://docs.instacloud.com/reference/gated-actions.md): The governable actions and default policy.
- [Limits](https://docs.instacloud.com/reference/limits.md): Per-plan and platform limits.
- [Errors](https://docs.instacloud.com/reference/errors.md): Common errors and what to do.
- [FAQ](https://docs.instacloud.com/reference/faq.md): Short answers to common questions.

## Optional

- [InstaCloud (hosted)](https://instacloud.com)
- [GitHub](https://github.com/InsForge/insta-oss)
- [Discord](https://discord.com/invite/MPxwj5xVvW)