Install Redocly CLI
Choose the most appropriate installation method for your needs:
- Install locally, using
npm
oryarn
to make theredocly
command available on your system. - Use
npx
to get the tool at runtime rather than installing it. - The command is also available via Docker if you'd prefer to use it that way.
Install globally
Make sure you have the newest version of npm
/yarn
before you begin.
- npm
- yarn
npm i -g @redocly/cli@latest
Running redocly --version
confirms that the installation was successful, and the currently-installed version of the tool.
Use npx
at runtime
npx is npm's package runner. It installs and runs a command without installing it globally. You might use this where you can't install a new command, or in a CI context where the command is only used a handful of times.
- Command
- Example with lint command
npx @redocly/cli <command> [options]
Run commands inside Docker
Redocly CLI is available as a pre-built Docker image in Docker Hub and GitHub Packages.
Install Docker if you don't have it already, then pull the image with the following command:
- Docker Hub
- GitHub Packages
docker pull redocly/cli
To give a Docker container access to your OpenAPI description files, you need to mount the containing directory as a volume. Assuming the API description is in the current working directory, the command to use is:
docker run --rm -v $PWD:/spec redocly/cli lint petstore.yaml
Next steps
- Set up autocomplete for Redocly CLI.
- Check the full list of Redocly CLI commands available.