mirror of
https://github.com/renovatebot/renovate.git
synced 2025-01-12 23:16:26 +00:00
50 lines
2.7 KiB
Markdown
50 lines
2.7 KiB
Markdown
|
|
|
|
# Renovate
|
|
|
|
Automated dependency updates. Flexible, so you don't need to be.
|
|
|
|
[](https://raw.githubusercontent.com/renovateapp/renovate/master/license)
|
|
[](https://codecov.io/gh/renovateapp/renovate)
|
|
[](https://gitter.im/renovate-app/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
|
[](https://david-dm.org/renovateapp/renovate)
|
|
[](https://renovateapp.com/)
|
|
|
|
## Why Use Renovate?
|
|
|
|
* Receive automated Pull Requests whenever dependencies need updating. Or whenever you schedule it for.
|
|
* Renovate discovers and processes all dependency files in a repository (e.g. supports
|
|
monorepo architecture such as lerna or yarn workspaces)
|
|
* Extremely customisable behaviour via configuration files or within your `package.json`
|
|
* Use eslint-like shared config presets for ease of use and simplifying configuration
|
|
* Update lock files natively in the same commit, including immediately resolving conflicts whenever PRs are merged
|
|
* Supports GitHub, GitLab (APIv4) and VSTS. BitBucket is a WIP.
|
|
* Open source (installable via npm/yarn) so can be self-hosted or used for free via GitHub App
|
|
|
|
## The Renovate Approach
|
|
|
|
* Everyone can benefit from automation, whether it's a little or a lot
|
|
* Renovate should not cause you to change your workflow against your wishes - don't enforce opinions on users
|
|
* All behaviour should be configurable, down to a ridiculous level if desired
|
|
* Autodetect settings wherever possible (to minimise configuration) but always allow overrides
|
|
|
|
## Using Renovate
|
|
|
|
The easiest way to use Renovate if you are on GitHub is to enable the free Renovate app. Go to
|
|
[https://github.com/apps/renovate](https://github.com/apps/renovate) to enable
|
|
it now.
|
|
|
|
## Configuration
|
|
|
|
The
|
|
[Configuration](https://github.com/renovateapp/renovate/blob/master/docs/configuration.md)
|
|
and
|
|
[Configuration FAQ](https://github.com/renovateapp/renovate/blob/master/docs/faq.md)
|
|
documents should be helpful.
|
|
|
|
You can also raise an issue in https://github.com/renovateapp/config-help if
|
|
you'd like to get your config reviewed or ask any questions.
|
|
|
|
## Self-Hosting
|
|
|
|
If you are not on GitHub or you prefer to run your own copy of Renovate, then it takes only seconds to set up. Please see [docs/self-hosting.md](https://github.com/renovateapp/renovate/blob/master/docs/self-hosting.md) for instructions.
|