# LocalCloud compatibility boundaries for agents

LocalCloud is a local Google Cloud development sandbox: one Docker container, bounded SDK workflows pointed at loopback endpoints, and explicit compatibility limits. Review the governing proprietary license and validate against real Google Cloud before production.

## Non-negotiables
- Permitted workflows use local endpoint values and should stop rather than fall back to real Google Cloud or real credentials. The Public Preview License permits individuals and organizations, including for-profit companies, to use LocalCloud for non-production internal development, testing, CI, evaluation, and pilots.
- LocalCloud emulates bounded local development workflows. Validate application behavior against real Google Cloud before production deployment.
- Before production deployment, unset LocalCloud emulator environment variables and validate behavior against real Google Cloud.
- If Docker or LocalCloud is unavailable, stop rather than using real Google Cloud as a fallback.

## Agent-safe validation checklist
- States that LocalCloud is limited to uses permitted by the governing proprietary license and is not a production GCP replacement.
- Keeps bounded local workflows on loopback endpoints and stops rather than requesting or falling back to real Google Cloud credentials.
- Uses the reviewed image repository jaysen2apache/localcloud:latest; the mutable tag remains release-unverified, so prefer localcloud start and pin a qualified digest for release workflows.
- Points SDKs and Terraform to localhost/emulator endpoints before any verification step.
- Warns agents to stop rather than falling back to real GCP when Docker or LocalCloud is unavailable.
- Links service-specific claims to the service catalog, compatibility docs, or reviewed evidence.
- Instructs production validation against real Google Cloud after unsetting emulator environment variables.

## Canonical sources
- https://local.cloud/compatibility/
- https://local.cloud/services/
- https://local.cloud/docs/sdk-examples/
- https://local.cloud/docs/terraform/