# Chalupa

> A disposable copy of the Compose services you pick. Chalupa launches the Docker Compose services you list in a chalupa.yml on a private server in your own cloud account, reaches them only through an SSH tunnel, and stops compute billing when you tear the server down. A declared data volume lives in a separate stack that survives teardown. Running an open model on a GPU is a second, experimental use.

Every page below is also served as raw markdown at the linked URL. The full product documentation in one file is at https://chalupa.run/llms-full.txt.

## Start here

- [Quickstart: run a test on a disposable environment](https://chalupa.run/docs/quickstart-compose.md): Install, preview for free, launch, tunnel, test and tear down.
- [Stack recipes](https://chalupa.run/docs/recipes.md): Starter chalupa.yml files for web and database stacks, queues and search, and replica sets.
- [Chalupa for agents](https://chalupa.run/docs/agents.md): Give an AI agent a private environment to work against and a contract that says what each action costs and needs.
- [What a run leaves behind](https://chalupa.run/docs/evidence.md): What each integration does today, what is Beta, and what is not built yet.

## Run and test

- [chalupa.yml reference](https://chalupa.run/docs/chalupa-yml.md): Declarative fields and a complete example.
- [Lifecycle](https://chalupa.run/docs/lifecycle.md): Prepare, launch, observe, and sink.
- [Declarative CI](https://chalupa.run/docs/ci.md): Declare test commands and run them in a disposable environment.
- [Data and seeds](https://chalupa.run/docs/data-seeds.md): Separate persistence and repeatable restores.
- [Tunnels and security](https://chalupa.run/docs/tunnels-security.md): Private services, local access, and secrets.
- [Secrets with tvault](https://chalupa.run/docs/secrets-tvault.md): Least-privilege injection without files or values in logs.
- [Local CLI and operator UI](https://chalupa.run/docs/local-cli.md): Inspect and operate a Chalupa from an offline-first terminal.

## Results and evidence

- [Suites and artifacts](https://chalupa.run/docs/suites-artifacts.md): Results, comparisons, and evidence references.
- [Private log artifacts](https://chalupa.run/docs/private-log-artifacts.md): Bounded direct uploads, commit verification, and retention.
- [Performance telemetry](https://chalupa.run/docs/performance-telemetry.md): Durable Monitor windows, privacy boundaries, and charts.
- [Hosted console](https://chalupa.run/docs/control-plane-agent.md): How heartbeats reach the hosted console, and what each console page shows.

## Speed and cost

- [Make servers ready faster](https://chalupa.run/docs/faster-boxes.md): Where boot time goes, what a prebaked image changes, how to check readiness, and what is coming next.
- [Costs and idle observation](https://chalupa.run/docs/costs-idle.md): Estimates and the informational inactivity window.
- [Plans, billing, and managed hours](https://chalupa.run/docs/billing.md): Hosted plans, Stripe lifecycle, credits, and provider-cost boundaries.

## Models on a GPU

- [Quickstart: managed GPU](https://chalupa.run/docs/quickstart.md): Set up a managed GPU, run a local coding agent, and stop compute.
- [Remote GPU inference](https://chalupa.run/docs/inference.md): Experimental host Ollama through a local SSH tunnel.
- [Agent harnesses](https://chalupa.run/docs/harnesses.md): Connect OpenCode, oh-my-pi, or Crush to your GPU model.
- [Providers](https://chalupa.run/docs/providers.md): Supported providers, billing units, and planned GPU adapters.
- [Managed GPU](https://chalupa.run/docs/managed-gpu.md): Prepaid GPU balance, rates, and beta availability.

## Reference

- [Concepts](https://chalupa.run/docs/concepts.md): The mental model: inference, compute, and data.
- [Troubleshooting](https://chalupa.run/docs/troubleshooting.md): Safe diagnosis for the most common failures.
- [API and schema](https://chalupa.run/docs/api-schema.md): Public ingestion and read contracts.