gcloud beta emulators pubsub start

NAME
gcloud beta emulators pubsub start - start a local pubsub emulator
SYNOPSIS
gcloud beta emulators pubsub start[--data-dir=DATA_DIR][--host-port=HOST_PORT][GCLOUD_WIDE_FLAG …]
DESCRIPTION
(BETA) This command starts a local pubsub emulator.

On successful start up, you should expect to see:

…[pubsub]ThisistheGooglePub/Subfake.[pubsub]Implementationmaybeincompleteordifferfromtherealsystem.…[pubsub]INFO:Serverstarted,listeningon8538
EXAMPLES
To start a local pubsub emulator, run:
gcloudbetaemulatorspubsubstart--data-dir=DATA-DIR
FLAGS
--data-dir=DATA_DIR
The directory to be used to store/retrieve data/config for an emulator run. Thedefault value is<USER_CONFIG_DIR>/emulators/pubsub. Thevalue of USER_CONFIG_DIR can be found by running:
gcloudinfo--format='get(config.paths.global_config_dir)'
--host-port=HOST_PORT
The host:port to which the emulator should be bound. The default value is[::1]:8085.
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 beta and might change without notice. This variantis also available:
gcloudalphaemulatorspubsubstart

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-07-22 UTC.