Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hawtio/hawtio
Hawtio web console helps you manage your JVM stuff and stay cool!
https://github.com/hawtio/hawtio
console hawtio java spring-boot web-app
Last synced: 30 days ago
JSON representation
Hawtio web console helps you manage your JVM stuff and stay cool!
- Host: GitHub
- URL: https://github.com/hawtio/hawtio
- Owner: hawtio
- License: apache-2.0
- Created: 2012-12-02T11:58:08.000Z (almost 12 years ago)
- Default Branch: 4.x
- Last Pushed: 2024-04-11T09:04:21.000Z (7 months ago)
- Last Synced: 2024-04-14T07:56:01.801Z (7 months ago)
- Topics: console, hawtio, java, spring-boot, web-app
- Language: Java
- Homepage: https://hawt.io/
- Size: 99.8 MB
- Stars: 1,393
- Watchers: 116
- Forks: 533
- Open Issues: 41
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- License: LICENSE.txt
Awesome Lists containing this project
README
![hawtio][logo]
[](https://github.com/hawtio/hawtio/actions/workflows/test.yml)
[](https://github.com/hawtio/hawtio/actions/workflows/e2e_test.yml)
## Introduction
[Hawtio](https://hawt.io) is a lightweight and modular Web console for managing Java applications.
Hawtio has [plugins](https://hawt.io/docs/plugins/) such as: Apache Camel and JMX (Logs, Spring Boot, Quartz, and more will be provided soon).
You can dynamically extend Hawtio with [your own plugins](https://github.com/hawtio/hawtio-sample-plugin-ts) or automatically discover plugins inside the JVM.
The only server side dependency (other than the static HTML/CSS/JS/images) is the excellent [Jolokia library](http://jolokia.org) which has small footprint (around 300KB) and is available as a [JVM agent](http://jolokia.org/agent/jvm.html), or comes embedded as a servlet inside the `hawtio-default.war`.
## Get Started
- [Running from CLI](#running-from-cli-jbang)
- [Running a Spring Boot app](#running-a-spring-boot-app)
- [Running a Quarkus app](#running-a-quarkus-app)
- [Deploying on OpenShift](https://github.com/hawtio/hawtio-online)
For more details and other containers, see [Get Started Guide](https://hawt.io/docs/get-started/).
### Running from CLI (JBang)
If you haven't installed [JBang](https://www.jbang.dev/) yet, first install it:
You can start up Hawtio on your machine using the following `jbang` command.
```console
jbang app install hawtio@hawtio/hawtio
hawtio --help
```
### Running a Spring Boot app
> [!NOTE]
> Hawtio v4 supports Spring Boot 3.x.
You can attach the Hawtio console to your Spring Boot app with the following steps.
1. Add `io.hawt:hawtio-springboot` to the dependencies in `pom.xml`:
```xml
io.hawt
hawtio-springboot
4.2.0
```
2. Enable the Hawtio and Jolokia endpoints by adding the following line in `application.properties`:
```java
management.endpoints.web.exposure.include=hawtio,jolokia
spring.jmx.enabled=true
```
Now you should be able to run Hawtio in your Spring Boot app as follows:
```console
mvn spring-boot:run
```
Opening should show the Hawtio console.
See [Spring Boot example](https://github.com/hawtio/hawtio/tree/hawtio-4.2.0/examples/springboot) for a working example app.
### Running a Quarkus app
> [!NOTE]
> Hawtio v4 supports Quarkus 3.x.
You can attach the Hawtio console to your Quarkus app by adding `io.hawt:hawtio-quarkus` to the dependencies in `pom.xml`:
```xml
io.hawt
hawtio-quarkus
4.2.0
```
Now you should be able to run Hawtio with your Quarkus app in development mode as follows:
```console
mvn compile quarkus:dev
```
Opening should show the Hawtio console.
See [Quarkus example](https://github.com/hawtio/hawtio/tree/hawtio-4.2.0/examples/quarkus) for a working example app.
## Contributing
We love [contributions](https://hawt.io/docs/contributing)! Here are the resources on how to get you involved in Hawtio development.
- [FAQ](https://hawt.io/docs/faq)
- [Change Log](CHANGES.md)
- [How to contribute](https://hawt.io/docs/contributing)
- [Community](https://hawt.io/community/)
Check out the [GitHub issues](https://github.com/hawtio/hawtio/issues) for finding issues to work on.
## License
Hawtio is licensed under [Apache License, Version 2.0](LICENSE.txt).
[logo]: https://hawt.io/_/img/hawtio_logo.svg "hawtio"