# LocalCloud services for agents

25 services run locally. Firestore, GKE, and Cloud Run are opt-in: `--services` sets the exact list of service IDs to run, so include every service the project needs, for example `localcloud start --local-only --services firestore,bigtable,spanner`. Compute Engine and Vertex AI are unsupported locally; use Google Cloud for them.

Once LocalCloud is running (https://local.cloud/ai/agents.md), `localcloud env` exports these values with the ports the CLI actually uses.

| Service | Default | Endpoints | Environment variable | Guide |
| --- | --- | --- | --- | --- |
| Firestore | opt-in (`firestore`) | gRPC :5384 | `FIRESTORE_EMULATOR_HOST=localhost:5384` | [guide](https://local.cloud/services/firestore/) |
| Bigtable | on | gRPC :5385 | `BIGTABLE_EMULATOR_HOST=localhost:5385` | [guide](https://local.cloud/services/bigtable/) |
| Spanner | on | gRPC :5386 · HTTP/REST :5387 | `SPANNER_EMULATOR_HOST=localhost:5386` | [guide](https://local.cloud/services/spanner/) |
| AlloyDB | on | gRPC :5380 | `ALLOYDB_EMULATOR_HOST=localhost:5380` | [guide](https://local.cloud/services/alloydb/) |
| Memorystore (Redis/Valkey) | on | RESP :5390 | `REDIS_HOST=localhost:5390` | [guide](https://local.cloud/services/memorystore/) |
| Cloud SQL | on | HTTP/REST :5380 · PostgreSQL :5391 · MySQL :5406 | `CLOUD_SQL_EMULATOR_HOST=http://localhost:5380` | [guide](https://local.cloud/services/cloud-sql/) |
| Pub/Sub | on | gRPC :5383 | `PUBSUB_EMULATOR_HOST=localhost:5383` | [guide](https://local.cloud/services/pubsub/) |
| Cloud Tasks | on | gRPC :5380 | `CLOUD_TASKS_EMULATOR_HOST=localhost:5380` | [guide](https://local.cloud/services/cloud-tasks/) |
| Cloud Scheduler | on | gRPC + HTTP/REST :5380 | `CLOUD_SCHEDULER_EMULATOR_HOST=localhost:5380` | [guide](https://local.cloud/services/cloud-scheduler/) |
| Cloud Workflows | on | gRPC :5380 | `WORKFLOWS_EMULATOR_HOST=localhost:5380` | [guide](https://local.cloud/services/cloud-workflows/) |
| Cloud Functions (2nd Gen) | on | gRPC :5380 | `CLOUD_FUNCTIONS_EMULATOR_HOST=localhost:5380` | [guide](https://local.cloud/services/cloud-functions/) |
| GKE | opt-in (`gke`) | gRPC :5380 · k3d :5443 | `GKE_EMULATOR_HOST=localhost:5380` | [guide](https://local.cloud/services/gke/) |
| Cloud Run | opt-in (`cloudrun`) | gRPC :5380 | `CLOUD_RUN_EMULATOR_HOST=localhost:5380` | [guide](https://local.cloud/services/cloud-run/) |
| Secret Manager | on | gRPC :5380 | `SECRET_MANAGER_EMULATOR_HOST=localhost:5380` | [guide](https://local.cloud/services/secret-manager/) |
| Cloud IAM | on | gRPC :5380 | `IAM_EMULATOR_HOST=localhost:5380` | [guide](https://local.cloud/services/cloud-iam/) |
| Cloud KMS | on | gRPC + HTTP/REST :5380 | `CLOUD_KMS_EMULATOR_HOST=localhost:5380` | [guide](https://local.cloud/services/cloud-kms/) |
| Cloud Resource Manager | on | HTTP/REST :5380 | `CLOUD_RESOURCE_MANAGER_EMULATOR_HOST=http://localhost:5380` | [guide](https://local.cloud/services/cloud-resource-manager/) |
| Service Usage | on | HTTP/REST :5380 | `SERVICE_USAGE_EMULATOR_HOST=http://localhost:5380` | [guide](https://local.cloud/services/service-usage/) |
| Cloud Billing | on | HTTP/REST :5380 | `CLOUD_BILLING_EMULATOR_HOST=http://localhost:5380` | [guide](https://local.cloud/services/cloud-billing/) |
| Cloud Logging | on | gRPC :5380 | `CLOUD_LOGGING_EMULATOR_HOST=localhost:5380` | [guide](https://local.cloud/services/cloud-logging/) |
| Cloud Monitoring | on | gRPC :5380 | `CLOUD_MONITORING_EMULATOR_HOST=localhost:5380` | [guide](https://local.cloud/services/cloud-monitoring/) |
| Cloud Storage | on | HTTP/REST :5382 | `STORAGE_EMULATOR_HOST=http://localhost:5382` | [guide](https://local.cloud/services/cloud-storage/) |
| BigQuery | on | HTTP/REST :5388 · gRPC :5389 | `BIGQUERY_EMULATOR_HOST=http://localhost:5388` | [guide](https://local.cloud/services/bigquery/) |
| Dataproc | on | gRPC :5380 | `DATAPROC_EMULATOR_HOST=localhost:5380` | [guide](https://local.cloud/services/dataproc/) |
| Google Sheets | on | HTTP/REST :5380 | `SHEETS_EMULATOR_HOST=http://localhost:5380` | [guide](https://local.cloud/services/google-sheets/) |

## Unsupported locally
- [Compute Engine](https://local.cloud/services/compute-engine/) — use Google Cloud.
- [Vertex AI](https://local.cloud/services/vertex-ai/) — use Google Cloud.

Capabilities and boundaries per service: https://local.cloud/ai/compatibility.md