storybook/docs/api/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
--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
--disable-telemetry	Disables Storybook's telemetry. Learn more about it here start-storybook --disable-telemetry

💡 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
--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.