cli-options.md

title
CLI options

Storybook comes with two CLI utilities: start-storybook and build-storybook.

Storybook collects completely anonymous data to help us improve user experience. Participation is optional, and you may opt-out if you'd not like to share any information.

Pass these commands the following options to alter Storybook's behavior.

start-storybook

Usage: start-storybook [options]

Options	Description
--help	Output usage information start-storybook --help
-V, --version	Output the version number start-storybook -V
-p, --port [number]	Port to run Storybook start-storybook -p 9009
-h, --host [string]	Host to run Storybook start-storybook -h my-host.com
-s, --static-dir	Deprecated see note. Directory where to load static files from, comma-separated list start-storybook -s public
-c, --config-dir [dir-name]	Directory where to load Storybook configurations from start-storybook -c .storybook
--https	Serve Storybook over HTTPS. Note: You must provide your own certificate information start-storybook --https
--ssl-ca	Provide an SSL certificate authority. (Optional with --https, required if using a self-signed certificate) start-storybook --ssl-ca my-certificate
--ssl-cert	Provide an SSL certificate. (Required with --https) start-storybook --ssl-cert my-ssl-certificate
--ssl-key	Provide an SSL key. (Required with --https) start-storybook --ssl-key my-ssl-key
--smoke-test	Exit after successful start start-storybook --smoke-test
--ci	CI mode (skip interactive prompts, don't open browser) start-storybook --ci
--no-open	Do not open Storybook automatically in the browser start-storybook --no-open
--quiet	Suppress verbose build output start-storybook --quiet
--no-dll	Do not use dll reference (no-op) start-storybook --no-dll
--debug-webpack	Display final webpack configurations for debugging purposes start-storybook --debug-webpack
--webpack-stats-json	Write Webpack Stats JSON to disk start-storybook --webpack-stats-json /tmp/webpack-stats
--docs	Starts Storybook in documentation mode. Learn more about it in here start-storybook --docs
--no-manager-cache	Disables Storybook's manager caching mechanism. See note below start-storybook --no-manager-cache
--disable-telemetry	Disables Storybook's telemetry. Learn more about it here start-storybook --disable-telemetry

💡 The flag --no-manager-cache disables the internal caching of Storybook and can severely impact your Storybook loading time, so only use it when you need to refresh Storybook's UI, such as when editing themes.

💡 Starting in 6.4 the -s flag is deprecated. Instead, use a configuration object in your .storybook/main.js file. See the images and assets documentation for more information.

build-storybook

Usage: build-storybook [options]

Options	Description
-h, --help	Output usage information build-storybook --help
-V, --version	Output the version number build-storybook -V
-s, --static-dir	Deprecated see note. Directory where to load static files from, comma-separated list build-storybook -s public
-o, --output-dir [dir-name]	Directory where to store built files build-storybook -o /my-deployed-storybook
-c, --config-dir [dir-name]	Directory where to load Storybook configurations from build-storybook -c .storybook
--loglevel [level]	Controls level of logging during build. Available options: silly, verbose, info (default), warn, error, silent build-storybook --loglevel warn
--quiet	Suppress verbose build output build-storybook --quiet
--no-dll	Do not use dll reference (no-op) build-storybook --no-dll
--debug-webpack	Display final webpack configurations for debugging purposes build-storybook --debug-webpack
--webpack-stats-json	Write Webpack Stats JSON to disk build-storybook --webpack-stats-json /my-storybook/webpack-stats
--docs	Builds Storybook in documentation mode. Learn more about it in here build-storybook --docs
--disable-telemetry	Disables Storybook's telemetry. Learn more about it here. build-storybook --disable-telemetry

💡 If you're using npm instead of yarn to publish Storybook, the commands work slightly different. For example, npm run build-storybook -- -o ./path/to/build.