# Besu Ethereum Client
[![CircleCI ](https://circleci.com/gh/hyperledger/besu/tree/master.svg?style=svg )](https://circleci.com/gh/hyperledger/besu/tree/master)
[![Total alerts ](https://img.shields.io/lgtm/alerts/g/hyperledger/besu.svg?logo=lgtm&logoWidth=18 )](https://lgtm.com/projects/g/hyperledger/besu/alerts/)
[![Language grade: Java ](https://img.shields.io/lgtm/grade/java/g/hyperledger/besu.svg?logo=lgtm&logoWidth=18 )](https://lgtm.com/projects/g/hyperledger/besu/context:java)
[![Documentation Status ](https://readthedocs.org/projects/hyperledger-besu/badge/?version=latest )](https://besu.hyperledger.org/en/latest/?badge=latest)
[![CII Best Practices ](https://bestpractices.coreinfrastructure.org/projects/3174/badge )](https://bestpractices.coreinfrastructure.org/projects/3174)
[![License ](https://img.shields.io/badge/License-Apache%202.0-blue.svg )](https://github.com/PegasysEng/besu/blob/master/LICENSE)
[ ![Download ](https://api.bintray.com/packages/hyperledger-org/besu-repo/besu/images/download.svg ) ](https://bintray.com/hyperledger-org/besu-repo/besu/_latestVersion)
[![RocketChat chat ](https://open.rocket.chat/images/join-chat.svg )](https://chat.hyperledger.org/channel/besu)
Besu is an Apache 2.0 licensed, MainNet compatible, Ethereum client written in Java.
## Issues
Besu issues are tracked in [Jira ](https://pegasys1.atlassian.net/secure/Dashboard.jspa?selectPageId=10117 ) not GitHub.
See our [contribution guidelines ](CONTRIBUTING.md ) for more detail on searching and creating issues.
If you've commented on an existing issue and have been waiting for a reply, feel free to ping us on [RocketChat].
## Besu Users
The process for installing and running Besu as a user is different to when developing. Some processes in our [user documentation ](https://besu.hyperledger.org/en/latest/ ) are different to those described in this Readme.
## Besu Developers
* [Contribution Guidelines ](CONTRIBUTING.md )
* [Coding Conventions ](CODING-CONVENTIONS.md )
* [Command Line Interface (CLI) Style Guide ](CLI-STYLE-GUIDE.md )
* [User Documentation] for running and using Besu
### Development
Instructions for how to get started with developing on the Besu codebase. Please also read the
[contribution guidelines ](CONTRIBUTING.md ) for more detail on how to submit a pull request (PR).
* [Checking Out and Building ](docs/development/building.md )
* [Running Developer Builds ](docs/development/running-developer-builds.md )
* [Code Coverage ](docs/development/code-coverage.md )
* [Logging ](docs/development/logging.md )
[User Documentation]: https://besu.hyperledger.org/
[RocketChat]: https://chat.hyperledger.org/channel/besu
## Release Notes
[Release Notes ](CHANGELOG.md )