# Helmr > Build your own coding agent runtime. Helmr runs TypeScript tasks in writable workspaces inside isolated Firecracker-backed Linux guests, with declared secrets, logs, session streams, run history, and durable waits before side effects. Official site: https://helmr.dev/ Documentation: https://helmr.dev/docs Source code: https://github.com/helmrdotdev/helmr ## Product Context - The public website and documentation describe the self-hosted runtime and developer workflows. - Use current docs pages as the source of truth for setup, concepts, self-hosting, and reference material. ## Core Pages - [Home](https://helmr.dev/): Build your own coding agent runtime. - [Docs](https://helmr.dev/docs): Documentation index for installing, operating, and extending Helmr. ## Start - [Overview](https://helmr.dev/docs/start/overview): What Helmr is, what it owns, and where to start. - [Quickstart](https://helmr.dev/docs/start/quickstart): Run Helmr locally, define a task project, and start work in a durable workspace. - [Architecture](https://helmr.dev/docs/start/architecture): The runtime components behind Helmr workspaces, sessions, and runs. ## Concepts - [Product model](https://helmr.dev/docs/concepts/product-model): The main Helmr objects and how they relate to each other. - [Projects](https://helmr.dev/docs/concepts/projects): How projects and environments scope Helmr work. - [Task projects](https://helmr.dev/docs/concepts/task-projects): The source layout Helmr indexes and deploys. - [Tasks](https://helmr.dev/docs/concepts/tasks): The TypeScript unit of work Helmr deploys and runs. - [Sandboxes](https://helmr.dev/docs/concepts/sandboxes): How tasks declare images, resources, and workspace mounts. - [Runtime environment](https://helmr.dev/docs/concepts/runtime-environment): What Helmr provides inside a running task sandbox. - [Workspaces](https://helmr.dev/docs/concepts/workspaces): Durable workspace behavior, live materialization, exec, and PTY. - [Sessions](https://helmr.dev/docs/concepts/sessions): Task invocation history, streams, runs, and workspace attachment. - [Runs](https://helmr.dev/docs/concepts/runs): Execution attempts, logs, events, payloads, stream output, and task output. - [Schedules](https://helmr.dev/docs/concepts/schedules): Cron-based task automation, declarative schedules, imperative schedules, and scheduled task payloads. - [Streams, Tokens, And Timers](https://helmr.dev/docs/concepts/streams-tokens-timers): Durable session I/O, external completion, and long waits. - [Secrets](https://helmr.dev/docs/concepts/secrets): Declaring, storing, and binding run-time secret values. - [Security](https://helmr.dev/docs/concepts/security): The security boundaries and data handling rules in Helmr. ## Guides - [First task](https://helmr.dev/docs/guides/first-task): Create the smallest Helmr task project and understand the task shape. - [Deploy](https://helmr.dev/docs/guides/deploy): Upload task source from a helmr.config.ts project. - [Run tasks](https://helmr.dev/docs/guides/run-tasks): Start a deployed task with payloads, secrets, and an attached workspace. - [Human input](https://helmr.dev/docs/guides/approvals): Pause tasks for operator decisions or message input. - [Task secrets](https://helmr.dev/docs/guides/task-secrets): Store remote secrets and declare task runtime placements. - [Custom images](https://helmr.dev/docs/guides/custom-images): Build task images with the tools your workflow needs. - [Caching](https://helmr.dev/docs/guides/caching): Reuse dependency downloads during image builds. - [TypeScript session starts](https://helmr.dev/docs/guides/typescript-task-starts): Start and observe Helmr sessions from TypeScript. - [Schedules](https://helmr.dev/docs/guides/schedules): Define cron schedules in task source or create them from TypeScript. ## Self-hosting - [Overview](https://helmr.dev/docs/self-hosting/overview): The self-hosted Helmr deployment path and the services you operate. - [Requirements](https://helmr.dev/docs/self-hosting/requirements): Accounts, tools, network, and release artifacts required before deployment. - [Deploy on AWS](https://helmr.dev/docs/self-hosting/deploy-on-aws): Create the base AWS infrastructure from the AWS profiles. - [Configure GitHub](https://helmr.dev/docs/self-hosting/configure-github): Configure GitHub OAuth login for Helmr. - [Configure secrets](https://helmr.dev/docs/self-hosting/configure-secrets): Populate AWS Secrets Manager values required by the control plane and workers. - [Run migrations](https://helmr.dev/docs/self-hosting/run-migrations): Run the database migration ECS task before starting control-plane services. - [Start control](https://helmr.dev/docs/self-hosting/start-control): Enable the Helmr control and dispatcher services and check health and readiness. - [Start workers](https://helmr.dev/docs/self-hosting/start-workers): Enable worker capacity for Firecracker-backed run execution. - [Verify a run](https://helmr.dev/docs/self-hosting/verify-run): Confirm that login, workers, and run execution work together. - [Operate Helmr](https://helmr.dev/docs/self-hosting/operate-helmr): Day-two operations for control, workers, secrets, checkpoints, and upgrades. - [Troubleshooting](https://helmr.dev/docs/self-hosting/troubleshooting): Common setup failures and the first checks to make. ## Reference - [CLI reference](https://helmr.dev/docs/reference/cli): Commands and environment used by the helmr CLI. - [SDK authoring](https://helmr.dev/docs/reference/sdk-authoring): TypeScript task, sandbox, image, source, workspace, and run I/O APIs. - [Runtime client](https://helmr.dev/docs/reference/runtime-client): TypeScript client APIs for starting tasks, opening workspaces, and inspecting sessions and runs. - [Configuration reference](https://helmr.dev/docs/reference/configuration): Task project, sandbox, image, resource, and secret configuration. - [REST API](https://helmr.dev/docs/reference/rest-api): Control-plane API routes used by the CLI, SDK, web UI, and workers. - [Run events](https://helmr.dev/docs/reference/run-events): Run event records and SDK event types. - [Environment variables](https://helmr.dev/docs/reference/environment-variables): Environment variables read by Helmr control, worker, CLI, deploy adapter, and SDK client. ## Full Text - [llms-full.txt](https://helmr.dev/llms-full.txt): Expanded Markdown-oriented corpus for language models.