FAQ

General

What is LocalCloud?

LocalCloud is a local Google Cloud runtime that brings the major Google Cloud services teams reach for first into a single Docker container. It gives you one boot path, one localhost handoff for SDKs, and a built-in console for inspecting the runtime locally.

Is LocalCloud free?

Yes. LocalCloud is free to use for developers.

How is this different from individual Google emulators?

Google provides some emulator paths, but you still have to run and manage them separately. LocalCloud wraps the major services developers need into one container, exports the right localhost environment variables, exposes health and service metadata, loads seed data, and gives you a console to inspect the whole runtime in one place.

Compatibility

Do I need to change my application code?

No. LocalCloud works with standard GCP SDK and CLI clients. You only change environment variables to point service endpoints at localhost. Switching back to real GCP is done by unsetting those env. variables.

Which SDK languages are supported?

Any language with GCP SDK support works: Python, Node.js, Go, Java, C#, Ruby, PHP, and more. The emulators speak the same gRPC/REST protocols as real GCP.

How complete is the BigQuery emulation?

There is no official BigQuery emulator from Google. so the BigQuery Emulator is built from scratch on top of duckdb in localcloud. The BigQuery emulator provides ~96% SQL coverage, 818 functional tests, 200+ mapped functions and features. It covers common DQL, DDL, DML, scripting, stored procedures, external tables, INFORMATION_SCHEMA views, REST APIs, and simplified gRPC Storage API paths. some of the features that you only care on production like BQML, encryption, security policy enforcement, and full geography parity are not supported; **geography is partial with 12 working ST_* functions.

Can I use this in CI/CD?

Yes. LocalCloud runs in any environment with Docker support. Add it as a service in your CI pipeline:

# GitHub Actions example
services:
  localcloud:
    image: jaysen2apache/localcloud
    ports:
      - 8080:8080
      - 4443:4443
      - 8085-8087:8085-8087
      - 9010:9010
      - 9020:9020
      - 9050:9050
      - 9060:9060
      - 6379:6379

Performance

How much memory does LocalCloud need?

Recommended: 4GB (-m 4g). With fewer services enabled, 2GB may suffice.

How long does it take to start?

The default boot path is designed to come up in less than 1 minute on a typical development machine.

Is data persisted between restarts?

Yes, if you mount a Docker volume to /var/lib/localcloud. Without a volume, data is lost when the container stops.

Troubleshooting

Port conflicts

If a port is already in use, remap it:

docker run -d -p 9080:8080 ... jaysen2apache/localcloud

Service isn’t responding

Check service status:

curl http://localhost:8080/_localcloud/services

GKE/Compute/Cloud Run not starting

These services require Docker socket access:

docker run -d \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e LOCALCLOUD_ENABLE_GKE=true \
  ...