redoc/docs/deployment/intro.md

title	redirectFrom
Redoc deployment guide	/docs/quickstart/intro/

Redoc deployment guide

Redoc offers multiple options for rendering your OpenAPI definition. You should select the option that best fits your needs.

The following options are supported:

• Live demo: The live demo offers a fast way to see how your OpenAPI will render with Redoc. A version of the Swagger Petstore API is displayed by default. To test it with your own OpenAPI definition, enter the URL for your definition and select TRY IT.
• HTML element: Using the HTML element works well for typical website deployments.
• React component: Using the React component is an option for users with a React-based application.
• Docker image: Using the Docker image works in a container-based deployment.
• CLI: Using the CLI is an option for users who prefer to use a command-line interface.

Before you start

OpenAPI definition

You will need an OpenAPI definition. For testing purposes, you can use one of the following sample OpenAPI definitions:

• OpenAPI 3.0
  • Rebilly Users OpenAPI Definition
  • Swagger Petstore Sample OpenAPI Definition
• OpenAPI 2.0
  • Thingful OpenAPI Definition
  • Fitbit Plus OpenAPI Definition

::: OpenAPI Specification info For more information on the OpenAPI specification, refer to the Learning OpenAPI 3 section in the documentation. :::

Running Redoc locally

If you want to view your Redoc output locally, you can simulate an HTTP server.

Using Redocly OpenAPI CLI

Redocly OpenAPI CLI is an open source command-line tool that includes a command for simulating an HTTP server to provide a preview of your OpenAPI definition locally.

If you have OpenAPI CLI installed, cd into your project directory and run the following command:

openapi preview-docs openapi.yaml

::: openapi.yaml Replace openapi.yaml in the example command with the file path to your OpenAPI definition. :::

By default, without providing a port, the preview starts on port 8080, and can be accessed at http://localhost:8080. To exit the preview, use control+C.

You can alter the port if you are using 8080 already, for example:

openapi preview-docs -p 8888 openapi.yaml

::: openapi.yaml Replace openapi.yaml in the example command with the file path to your OpenAPI definition. :::

For more information about the preview-docs command, refer to OpenAPI CLI commands in the OpenAPI CLI documentation.

Using Python

If you have Python 3 installed, cd into your project directory and run the following command:

python3 -m http.server

If you have Python 2 installed, cd into your project directory and run the following command:

python -m SimpleHTTPServer 8000

The output after entering the command provides the local URL where the preview can be accessed. To exit the preview, use control-C.

Using Node.js

If you have Node.js installed, install http-server using the following npm command:

npm install -g http-server

Then, cd into your project directory and run the following command:

http-server

The output after entering the command provides the local URL where the preview can be accessed. To exit the preview, use control-C.