- 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 ] This is the Google Pub/Sub fake. [ pubsub ] Implementation may be incomplete or differ from the real system. … [ pubsub ] INFO: Server started, listening on 8538
- EXAMPLES
- To start a local pubsub emulator, run:
gcloud beta emulators pubsub start --data-dir = DATA-DIR - FLAGS
-
-
--data-dir=DATA_DIR - The directory to be used to store/retrieve data/config for an emulator run. The
default value is
<USER_CONFIG_DIR>/emulators/pubsub. The value of USER_CONFIG_DIR can be found by running:gcloud info --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 helpfor details. - NOTES
- This command is currently in beta and might change without notice. This variant
is also available:
gcloud alpha emulators pubsub start
gcloud beta emulators pubsub start
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.

