> For the complete documentation index, see [llms.txt](https://semantic-release.gitbook.io/semantic-release/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://semantic-release.gitbook.io/semantic-release/beta/usage/getting-started.md).

# Getting started

In order to use **semantic-release** you must follow these steps:

1. [Install](/semantic-release/beta/usage/installation.md#installation) **semantic-release** in your project
2. Configure your Continuous Integration service to [run **semantic-release**](/semantic-release/beta/usage/ci-configuration.md#run-semantic-release-only-after-all-tests-succeeded)
3. Configure your Git repository and package manager repository [authentication](/semantic-release/beta/usage/ci-configuration.md#authentication) in your Continuous Integration service
4. Configure **semantic-release** [options and plugins](/semantic-release/beta/usage/configuration.md#configuration)

Alternatively those steps can be easily done with the [**semantic-release** interactive CLI](https://github.com/semantic-release/cli):

```bash
cd your-module
npx semantic-release-cli setup
```

![dialogue](https://1024786456-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGsE7zdvzHI5cG-XV6p%2F-Ll49N1uavFd1NAgGdHy%2F-Ll49NeApZUlP_GESfiH%2Fsemantic-release-cli.png?generation=1564528446996903\&alt=media)

See the [semantic-release-cli](https://github.com/semantic-release/cli#what-it-does) documentation for more details.

**Note**: only a limited number of options, CI services and plugins are currently supported by `semantic-release-cli`.