Runtime details
- Endpoints
- gRPC :24083
- Minimum tier
- community
- Persistence
- volatile
- Documented workflows
- 2
2 documented workflows
Run Firestore workflows locally
Document CRUD and query workflows through the local Firestore emulator. Enable it explicitly before use.
Documented workflows
- documents.create/read/update/delete
- queries/index behavior
Service boundaries
- Seed and browser parity is not fully hardened.
- Index/query behavior is unverified.
- documents.create/read/update/delete: External emulator is available; seed and browser parity needs hardening.
- queries/index behavior: Complex query/index parity is unverified.
- Documents do not have an audited persisted data directory in the assembled container
- Treat restart persistence as unsupported.
FAQ
Common questions
How do I run Firestore locally?
Install the LocalCloud host CLI, start the runtime, and load the generated environment values into your application process. Firestore is then reachable at the endpoints the CLI reports, and standard Google Cloud clients resolve to localhost instead of googleapis.com.
Which environment variable points the SDK at the local Firestore?
LocalCloud exports FIRESTORE_EMULATOR_HOST=localhost:24083. Read the value from the generated environment rather than assuming a fixed port, because occupied ports are remapped at startup.
What Firestore workflows are documented locally?
2 Firestore workflows are documented with operation-level status: documents.create/read/update/delete, queries/index behavior. The compatibility matrix lists the status of every operation.
Does the local Firestore behave exactly like Google Cloud?
No. LocalCloud implements documented local workflows with published boundaries, and compatibility is narrower than managed Google Cloud. Validate behavior against real Firestore before production deployment.
Can an AI coding agent use the local Firestore?
Yes. Because no cloud credentials or billing project are required by default, agent-written Firestore code can run against localhost without creating real cloud resources or charges.