gcloud alpha emulators spanner start

NAME
gcloud alpha emulators spanner start - start a local Cloud Spanner emulator
SYNOPSIS
gcloud alpha emulators spanner start[--enable-fault-injection=ENABLE_FAULT_INJECTION][--host-port=HOST_PORT][--rest-port=REST_PORT][--use-docker=USE_DOCKER][GCLOUD_WIDE_FLAG …]
DESCRIPTION
(ALPHA) This command starts a local Cloud Spanner emulator.
EXAMPLES
To start a local Cloud Spanner emulator, run:
gcloudalphaemulatorsspannerstart
FLAGS
--enable-fault-injection=ENABLE_FAULT_INJECTION
If true, the emulator will randomly inject faults into transactions. Thisfacilitates application abort-retry testing.
--host-port=HOST_PORT
The host:port to which the emulator should be bound. The default value islocalhost:9010. Note that this port serves gRPC requests. To override thedefault port serving REST requests, use --rest-port. If using Docker to run theemulator, the host must be specified as an ipaddress.
--rest-port=REST_PORT
The port at which REST requests are served. gcloud uses REST to communicate withthe emulator. The default value is 9020.
--use-docker=USE_DOCKER
Use the Cloud Spanner emulator docker image even if the platform has a nativebinary available in the gcloud CLI. Currently we only provide a native binaryfor Linux. For other systems, you must install Docker for your platform beforestarting the emulator.
GCLOUD WIDE FLAGS
These flags are available to all commands:--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.

Run$gcloud help for details.

NOTES
This command is currently in alpha and might change without notice. If thiscommand fails with API permission errors despite specifying the correct project,you might be trying to access an API with an invitation-only early accessallowlist. These variants are also available:
gcloudemulatorsspannerstart
gcloudbetaemulatorsspannerstart

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-05-07 UTC.