# inis.run

> Isolated Linux sandboxes for untrusted and AI-generated code. Persistent sessions, full Linux, CLI, SDKs, and MCP. Built in Ireland — your data stays in Europe.

This file is an index for humans and agents. Prefer the linked docs pages over inventing API shapes from memory. For a single file with the full text of every page below, see llms-full.txt.

Base URL: https://inis.run
API: https://api.inis.run
MCP (SSE): https://mcp.inis.run/sse
Auth: `Authorization: Bearer <api_key>`

## Start here

- [Introduction](https://inis.run/docs): What inis.run is and how to connect (CLI, Python, TypeScript, MCP).
- [Quickstart](https://inis.run/docs/quickstart): Install the CLI, sign in, run your first sandbox command.
- [Authentication](https://inis.run/docs/authentication): API keys and request auth.

## Core concepts

- [Concepts](https://inis.run/docs/concepts): Sessions, one-shot exec, preview URLs, fork, and checkpoints.
- [Session lifecycle](https://inis.run/docs/session-lifecycle): Templates, live vs paused, hot/warm/cold resume, timers, billing knobs, and gotchas. Read this before pause/resume/TTL work.
- [Templates](https://inis.run/docs/templates): Official base environments, versioning, and how to start from a template.
- [Best practices](https://inis.run/docs/best-practices): Persistence over recreate, resume/fork over cold starts, scoped credentials, locked-down egress, and argv-form exec.
- [Volumes](https://inis.run/docs/volumes): Durable block storage a session can attach to — create, attach, sizing, and what the durability guarantee actually covers.

## Capabilities

- [Networking & egress](https://inis.run/docs/networking): Per-session egress allowlist — deny-by-default outbound.
- [Security & data residency](https://inis.run/docs/security): Isolation, egress, teardown, and EU residency.
- [Artifacts](https://inis.run/docs/artifacts): Capture session files to durable storage with download links that outlive the session.

## Connect an agent or app

- [Agent recipes](https://inis.run/docs/agent-recipes): Task-oriented paths — keep state across turns, explore branches safely, cancel/time-bound work, recover from errors — each linked to runnable source.
- [Custom agent templates & MCP](https://inis.run/docs/mcp-guide): Build a template, spin sessions, connect session MCP, pause/resume patterns.
- [Remote MCP](https://inis.run/docs/integrations/mcp): Hosted org MCP at `https://mcp.inis.run/sse` and session-scoped MCP — tools, auth, Cursor config.
- [CLI](https://inis.run/docs/integrations/cli): `inis` command reference.
- [Python SDK](https://inis.run/docs/integrations/python): Sessions, exec, files, PTY, interpreter, pause/resume.
- [TypeScript SDK](https://inis.run/docs/integrations/typescript): Node / server-side client for the same surface.
- [Vercel AI SDK](https://inis.run/docs/integrations/ai-sdk): Pre-built tools for `streamText` / `generateText`. Beta.
- [Pydantic AI](https://inis.run/docs/integrations/pydantic-ai): Python agent toolset. Beta.
- [LangChain](https://inis.run/docs/integrations/langchain): Native Deep Agents backend, plus a LangGraph recipe. Beta.
- [OpenAI Agents SDK](https://inis.run/docs/integrations/openai-agents): Native sandbox providers for the SandboxAgent path, Python and TypeScript. Beta.
- [Strands Agents](https://inis.run/docs/integrations/strands-agents): Native sandbox providers for Strands' Sandbox surface, Python and TypeScript.
- [Mastra](https://inis.run/docs/integrations/mastra): Native sandbox provider for Mastra Workspaces. Beta.
- [Google ADK](https://inis.run/docs/integrations/google-adk): Python environment provider for Google Agent Development Kit. Experimental, upstream.
- [Microsoft Agent Framework](https://inis.run/docs/integrations/agent-framework): Native CodeAct provider for Microsoft Agent Framework.

## HTTP API reference

- [API overview](https://inis.run/docs/api/overview): REST surface for sandboxes and sessions.
- [Sessions](https://inis.run/docs/api/sessions): Create, exec, files, processes, expose, pause/resume, fork, checkpoints.
- [One-shot exec](https://inis.run/docs/api/execute): `POST /v1/sessions/exec` — run once and tear down.
- [Organisation](https://inis.run/docs/api/org): Capacity and account limits.
- [Errors](https://inis.run/docs/api/errors): Error envelope and machine-readable codes.

## Machine-readable

- [Raw docs corpus](https://inis.run/llms-full.txt): every page above concatenated into one file, for agents that need more than the index.
- [Public integration AGENTS.md](https://inis.run/docs/AGENTS.md): install, auth, owned-vs-attached session rules, and links for a coding agent adding an integration. Distinct from this repository's internal root AGENTS.md.
- [OpenAPI spec](https://inis.run/docs/openapi.yaml): full REST schema, `application/yaml`.
- [Support matrix](https://inis.run/docs/support-matrix.json): package names, supported ranges, lifecycle mode, and docs/example links per integration.
- [Canonical quickstart](https://github.com/inis-run/sdk/tree/main/examples/quickstart): the one executable Python/TypeScript example every other first-run surface reuses or is checked against.

## Optional

- [Pricing](https://inis.run/pricing): Public pricing page (not a docs deep-dive).
- [Security (marketing)](https://inis.run/security): Buyer-facing security surface.