Guides

Version:

Todas as opções de configuração Listar todas as propriedades de configuração por extensões

Creating your first application Build a REST API with live reload, dependency injection, and tests, in under 15 minutes.
Your second Quarkus application Discover some of the features that make developing with Quarkus a joyful experience.
Using our tooling Explore a cadeia de ferramentas para desenvolvedores do Quarkus, que torna o desenvolvimento do Quarkus tão rápido e agradável.
Quarkus tools in your favorite IDE Saiba mais sobre as integrações do Quarkus em IDEs.

Packaging overview An overview of the different ways to package a Quarkus application (JARs, uber-JARs, AOT caching, jlink images, native executables, and container images) with guidance on choosing the right option for your workload.
Ahead-of-time (AOT) caching This guide explains how to use Leyden AOT caching with Quarkus for dramatically faster startup times on JDK 24+.
Tree-shaking JAR dependencies This guide explains how to reduce JAR size by removing unreachable classes from runtime dependencies.
JLink packaging The jlink extension produces a custom Java runtime image containing only the modules needed to run the application.
Re-augment a Quarkus application Use JARs mutáveis para reconstruir sua aplicação com diferentes configurações de tempo de compilação.

Criação de um executável nativo Crie executáveis nativos com GraalVM ou Mandrel.
Native reference guide This guide is a companion to the Building a Native Executable, Using SSL With Native Images, and Writing Native Applications, guides.
Tips for writing native applications Este guia é uma coleção de dicas para ajudá-lo a resolver os problemas encontrados ao compilar aplicativos para executável nativo.
Using SSL with native executables In this guide, we will discuss how you can get your native images to support SSL, as native images don't support it out of the box.
Compactação de executáveis nativos com UPX Ultimate Packer for eXecutables (UPX) is a compression tool reducing the size of executables.

Imagens de Contêiner Learn how to build and push container images with Jib, OpenShift, Docker, or Podman as part of the Quarkus build.
Quarkus base runtime image To ease the containerization of native executables, Quarkus provides a base image providing the requirements to run these executables.

Generating and using CycloneDX SBOMs This guide explains how to generate and use SBOMs for Quarkus applications in the CycloneDX format.
Packaging and releasing with JReleaser This guide covers packaging and releasing CLI applications using the JReleaser tool.

Introduction to Contexts and Dependency Injection (CDI) Quarkus DI solution is based on the [Jakarta Contexts and Dependency Injection 4.1](https://jakarta.ee/specifications/cdi/4.1/jakarta-cdi-spec-4.1.html) specification.
Contextos e Injeção de Dependência Aprofunde-se na implementação do CDI no Quarkus.
Application initialization and termination You often need to execute custom actions when the application starts and clean up everything when the application stops.

Dev Services overview An introduction to Dev Services and a list of all extensions that support Dev Services and their configuration options.
Compose Dev Services Configure custom Dev Services using Docker or Podman Compose.
Usando o Podman com o Quarkus Podman is an open-source, daemonless, and rootless container engine for developing, managing, and running OCI Containers on Linux, Windows and Mac.

Configuring your application Hardcoded values in your code is a no go (even if we all did it at some point ;-)).
Configuração YAML Optionally, use application.yaml instead of application.properties to configure your application.
Mapeando configuração para objetos Agrupa várias propriedades de configuração num objeto.
Configuration reference guide Saiba mais sobre como configurar as suas aplicações Quarkus.
Extending configuration support Estenda e personalize a Configuração.
Todas as opções de configuração Listar todas as propriedades de configuração por extensões

Using Eclipse Vert.x API from a Quarkus application Este guia explica como usar o Vert.x no Quarkus para criar aplicativos reativos.
Vert.x reference guide Este guia de referência fornece detalhes avançados sobre o uso e a configuração da instância Vert.x usada pelo Quarkus.

Testing your application This guide covers testing in JVM mode, native mode, and injection of resources into tests
Continuous testing Obtenha feedback antecipado sobre os testes com o Teste Contínuo.
Testing components This reference guide covers the `QuarkusComponentTestExtension`, a JUnit extension to ease the testing of components and mocking of their dependencies.
Medindo a cobertura de seus testes Este guia explica como medir a cobertura de teste da sua aplicação Quarkus.

Quarkus for the Web Learn more about creating all kinds of Web applications with Quarkus.
HTTP reference Saiba mais sobre como configurar a camada HTTP baseada em Vert.x do Quarkus - e Undertow se você estiver usando servlets.
Usando rotas reativas Este guia demonstra como usar rotas reativas.

Writing REST services with Quarkus REST (formerly RESTEasy Reactive) Discover how to develop highly scalable reactive REST services with Jakarta REST and Quarkus REST.
Usando o Cliente REST This guide explains how to use the REST Client.
Escrevendo serviços JSON REST JSON is now the lingua franca between microservices.
Utilizar OpenAPI e Swagger UI Este guia explica como usar a extensão OpenAPI para gerar um descritor OpenAPI e obter um front-end da interface do usuário do Swagger para testar seus endpoints REST.
RESTEasy Classic
Using the legacy REST Client This guide explains how to use the RESTEasy Classic REST Client in order to interact with REST APIs (JSON and other) with very little effort.
Using the legacy REST Client with Multipart This guide explains how to use the RESTEasy Classic REST Client to send multipart REST requests, typically to upload documents.
Generating Jakarta REST resources with Panache Hibernate ORM REST Data with Panache simplifies the creation of CRUD applications based on Jakarta REST and Hibernate ORM.
Use virtual threads in REST applications How to use virtual threads in a REST application
Migrating to Quarkus REST (formerly RESTEasy Reactive) Migrating from RESTEasy Classic to Quarkus REST (formerly RESTEasy Reactive) is straightforward in most cases, however there are a few cases that require some attention.

SmallRye GraphQL Este guia explica como aproveitar o SmallRye GraphQL para implementar serviços GraphQL.
SmallRye GraphQL Client Este guia explica como aproveitar o Cliente SmallRye GraphQL para consumir serviços GraphQL.

Getting started with WebSockets Next Get started with WebSockets Next to create interactive web applications.
WebSockets Next reference guide The quarkus-websockets-next extension provides a modern declarative API to define WebSocket server and client endpoints.
Using WebSockets with Undertow This guide explains how your Quarkus application can utilize web sockets to create interactive web applications.

Web dependency locator Learn more about how to use the web dependency locator

Configure data sources in Quarkus Use a unified configuration model to define data sources for Java Database Connectivity (JDBC) and Reactive drivers.
Reactive SQL clients Este guia aborda como usar os clientes SQL reativos no Quarkus.
Dev Services for databases When testing or running in dev mode Quarkus can provide you with a zero-config database out of the box, a feature we refer to as Dev Services.

Usando Hibernate ORM e Jakarta Persistence Hibernate ORM is the de facto Jakarta Persistence implementation and offers you the full breadth of an Object Relational Mapper.
Simplified Hibernate with Quarkus Data Hibernate Hibernate is the de facto Jakarta Persistence implementation and offers you the full breadth of an Object Relational Mapper.
Hibernate ORM simplificado com Panache Panache focuses on making your Hibernate ORM entities trivial and fun to write.
Hibernate ORM simplificado com Panache e Kotlin This explains the specifics of using Hibernate ORM with Panache in a Kotlin project.
Usando o Hibernate Reactive Hibernate Reactive is a reactive API for Hibernate ORM, supporting non-blocking database drivers and a reactive style of interaction with the database.
Hibernate Reativo Simplificado com Panache Camada ORM reativa simplificada baseada no Hibernate Reactive.
Use Hibernate Search with Hibernate ORM and Elasticsearch/OpenSearch Hibernate Search with Hibernate ORM allows you to index your entities in an Elasticsearch/OpenSearch cluster and easily offer full text search in all your Hibernate ORM-based applications.
Use Hibernate Search in Standalone mode with Elasticsearch/OpenSearch Hibernate Search Standalone allows you to index your entities in an Elasticsearch/OpenSearch cluster and easily offer full text search in all your applications, even without Hibernate ORM.
Usando o Blaze-Persistence Este guia explica como usar o Blaze-Persistence para simplificar suas camadas de dados e DTO.

Using transactions in Quarkus The quarkus-narayana-jta extension provides a Transaction Manager that coordinates and exposes transactions to your applications as described in the Jakarta Transactions specification, formerly known as Java Transaction API (JTA).
Using Software Transactional Memory in Quarkus This guide covers the usage of Software Transactional Memory (STM).
Narayana LRA participant support This guide covers the usage of LRA to coordinate activities across services.
Dev Services for LRA Start the Narayana LRA coordinator automatically in dev and test modes.

Validação com o Hibernate Validator Este guia aborda a forma de utilizar o validador Hibernate/Bean Validation nos seus serviços REST.

Usando o cliente MongoDB Este guia aborda como usar o MongoDB no Quarkus.
Simplified MongoDB with Panache Este guia aborda o uso do MongoDB usando active records e repositórios.
Simplified MongoDB with Panache and Kotlin Este guia aborda o uso do MongoDB usando active records e repositórios em um projeto Kotlin.
Dev Services for MongoDB Quarkus supports a feature called Dev Services that allows you to create various datasources without any config.
Usando o Cliente Redis Este guia aborda como usar um datastore Redis no Quarkus.
Redis extension reference guide Redis is an in-memory data store used as a database, cache, streaming engine, and message broker.
Dev Services para Redis Iniciar o Redis automaticamente nos modos de desenvolvimento e teste.
Connecting to an Elasticsearch cluster This guide covers how to interact with an Elasticsearch cluster using the low level REST client or the Elasticsearch Java client.
Dev Services for Elasticsearch Start Elasticsearch automatically in dev and test modes
Using the Cassandra Client Este guia aborda como usar o banco de dados Apache Cassandra NoSQL no Quarkus.

Application data caching Este guia explica como armazenar em cache chamadas de método custosas de seus beans CDI usando anotações simples.
Cache Redis Use Redis as the Quarkus cache backend
Infinispan Cache Use Infinispan as the Quarkus cache backend
Using the Infinispan Client This guide covers how to use Infinispan with Quarkus.
Infinispan Client extension reference guide Infinispan is an in memory distributed data store and cache server that offers flexible deployment options and robust capabilities for storing, managing, and processing data.
Dev Services for Infinispan Start Infinispan automatically in dev and test modes.

Usando o Flyway Este guia aborda como usar a extensão Flyway para gerenciar suas migrações de esquema de banco de dados.
Using Liquibase Este guia aborda como usar a extensão Liquibase para gerenciar suas migrações de esquema.
Using Liquibase MongoDB Liquibase is an open source tool for database schema change management, it allows managing MongoDB databases via its MongoDB Extension.

Quarkus Messaging extensions Event-driven messaging systems have become the backbone of most modern applications, enabling the building of message-driven microservices or complex data streaming pipelines.
Quarkus virtual thread support with Reactive Messaging This guide explains how to benefit from Java virtual threads when writing message processing applications in Quarkus.

Quarkus Signals Learn more about how application components can interact in a loosely coupled fashion
Utilizar o barramento de eventos Este guia explica como diferentes beans podem interagir usando o barramento de eventos.

Usando JMS Este guia demonstra como a sua aplicação Quarkus pode utilizar mensagens JMS com AMQP 1.0 utilizando o Apache Qpid JMS, ou utilizando o Apache ActiveMQ Artemis JMS.

Getting started with Quarkus Messaging and Apache Kafka Build two applications that communicate via Apache Kafka using Quarkus Messaging.
Apache Kafka reference guide This reference guide provides an in-depth look on Apache Kafka and Quarkus Messaging extensions.
Dev Services para o Kafka Iniciar o Apache Kafka automaticamente nos modos de desenvolvimento e teste.
Usando Apache Kafka Streams Este guia demonstra como a sua aplicação Quarkus pode utilizar a API Apache Kafka Streams para implementar aplicações de processamento de fluxo baseadas no Apache Kafka.
Utilização do Apache Kafka com o Schema Registry e o Avro Use o Apache Kafka, Avro serialized records e conecte-se a um Schema Registry.
Using Apache Kafka with Schema Registry and JSON Schema Use Apache Kafka, Json Schema serialized records, and connect to a schema registry.
Kafka Dev UI Dev UI extension for Apache Kafka for development purposes.
Dev Services para Apicurio Registry Iniciar o Apicurio Registry automaticamente nos modos de desenvolvimento e teste.

Getting started with Quarkus Messaging and AMQP 1.0 This guide demonstrates how your Quarkus application can utilize Quarkus Messaging to interact with AMQP.
Reactive Messaging AMQP 1.0 Connector reference documentation This guide is the companion to the Getting Started with AMQP 1.0.
Dev Services para AMQP Iniciar o AMQP automaticamente nos modos de desenvolvimento e teste.

Getting started with Quarkus Messaging and Apache Pulsar This guide demonstrates how your Quarkus application can utilize Quarkus Messaging to interact with Apache Pulsar.
Apache Pulsar reference guide This reference guide provides an in-depth look on Apache Pulsar and the Quarkus Messaging extensions.
Dev Services para Pulsar With Quarkus Messaging Pulsar extension (quarkus-messaging-pulsar) Dev Services for Pulsar automatically starts a Pulsar broker in dev mode and when running tests.

Getting started with Quarkus Messaging and RabbitMQ This guide demonstrates how your Quarkus application can utilize Quarkus Messaging to interact with RabbitMQ.
Reactive Messaging RabbitMQ Connector reference documentation This guide is the companion to the Getting Started with RabbitMQ.
Dev Services for RabbitMQ Dev Services for RabbitMQ automatically starts a RabbitMQ broker in dev mode and when running tests.

Visão geral do Quarkus Security O Quarkus Security é um framework que fornece a arquitetura, múltiplos mecanismos de autenticação e autorização e outras ferramentas para desenvolver aplicativos Java seguros e com qualidade de produção.
Arquitetura da Segurança do Quarkus The Quarkus Security architecture provides several built-in authentication mechanisms and is highly customizable.
Getting started with security by using Basic authentication and Jakarta Persistence Get started with Quarkus Security by securing your Quarkus application endpoints with the built-in Quarkus Basic authentication and the Jakarta Persistence identity provider, enabling role-based access control.
Security tips and tricks
Authorization of web endpoints Quarkus incorporates a pluggable web security layer.
Autenticação proativa Learn how to manage proactive authentication in Quarkus, including customizing settings and handling exceptions.
Cross-Origin Resource Sharing (CORS) Enable and configure CORS in Quarkus to specify allowed origins, methods, and headers, guiding browsers in handling cross-origin requests safely.
Cross-Site Request Forgery prevention Cross-Site Request Forgery (CSRF) is an attack that forces an end user to execute unwanted actions on a web application in which they are currently authenticated.
Using security with .properties file Este guia demonstra como seu aplicativo Quarkus pode usar um arquivo .properties para armazenar suas identidades de usuário.
Security testing This document describes how to test Quarkus Security.
Secrets in configuration Use encrypted configuration values to protect sensitive passwords, secrets, tokens and keys.
Using a credentials provider This guide explains how to use the Vault credentials provider or implement your own custom one.
Using SSL with native executables In this guide, we will discuss how you can get your native images to support SSL, as native images don't support it out of the box.
Detecção e relatório de vulnerabilidades de segurança no Quarkus Most of the Quarkus tags are registered in the US National Vulnerability Database (NVD) in Common Platform Enumeration (CPE) name format.

Authentication mechanisms in Quarkus The Quarkus Security framework supports multiple authentication mechanisms, which you can use to secure your applications.
Autenticação básica HTTP Basic authentication is one of the least resource-demanding techniques that enforce access controls to web resources.
Habilitar a autenticação básica Enable Basic authentication to require a username and password before users can access your Quarkus application.
Usando JWT RBAC This guide explains how your application can use SmallRye JWT to provide secured access to the Jakarta REST endpoints.
Build, sign, and encrypt JSON Web Tokens JSON Web Token (JWT) is defined by the RFC 7519 specification as a compact, URL-safe means of representing claims.
Usando OAuth2 RBAC This guide explains how your Quarkus application can utilize OAuth2 tokens to provide secured access to the Jakarta REST endpoints.
Using security with WebAuthn Este guia demonstra como seu aplicativo Quarkus pode usar a autenticação WebAuthn em vez de senhas.

OpenID Connect authorization code flow mechanism for protecting web applications To protect your web applications, you can use the industry-standard OpenID Connect (OIDC) Authorization Code Flow mechanism provided by the Quarkus OIDC extension.
Protect a web application by using OpenID Connect (OIDC) authorization code flow Discover how to secure application HTTP endpoints by using the Quarkus OpenID Connect (OIDC) authorization code flow mechanism with the Quarkus OIDC extension, providing robust authentication and authorization.
OpenID Connect (OIDC) Bearer token authentication Secure HTTP access to Jakarta REST (formerly known as JAX-RS) endpoints in your application with Bearer token authentication by using the Quarkus OpenID Connect (OIDC) extension.
Protect a service application by using OpenID Connect (OIDC) Bearer token authentication Use the Quarkus OpenID Connect (OIDC) extension to secure a Jakarta REST application with Bearer token authentication.
Protect a Quarkus web application by using an Auth0 OpenID Connect provider Quarkus Security provides comprehensive OpenId Connect (OIDC) and OAuth2 support with its quarkus-oidc extension, supporting both Authorization code flow and Bearer token authentication mechanisms.
Propriedades de configuração do OpenID Connect (OIDC) As a Quarkus developer, you configure the Quarkus OpenID Connect (OIDC) extension by setting the following properties in the src/main/resources/application.properties file.
Quarkus OpenID Connect (OIDC) expanded configuration reference Quarkus OIDC quarkus-oidc extension provides a comprehensive, highly adaptable and configurable OIDC and OAuth2 adapter implementation.
Configuring well-known OpenID Connect providers This document explains how to configure well-known social OIDC and OAuth2 providers.
OpenID Connect client and token propagation quickstart Learn how to use OpenID Connect (OIDC) and OAuth2 clients with filters to get, refresh, and propagate access tokens in your applications.
OpenID Connect (OIDC) and OAuth2 client and filters You can use Quarkus extensions for OpenID Connect and OAuth 2.0 access token management, focusing on acquiring, refreshing, and propagating tokens.
OpenID Connect (OIDC) and OAuth2 dynamic client registration Typically, you have to register an OIDC client (application) manually in your OIDC provider’s dashboard.
Using OpenID Connect (OIDC) multitenancy This guide demonstrates how your OpenID Connect (OIDC) application can support multitenancy to serve multiple tenants from a single application.
Dev Services and Dev UI for OpenID Connect (OIDC) You can use Dev Services for Keycloak and the Dev UI for the OpenID Connect (OIDC) Keycloak provider and adapt these services for other OpenID Connect providers.
Migrate from Vert.x OIDC to Quarkus OIDC Learn how to migrate your Vert.x OIDC application to Quarkus and choose to either retain Vert.x OIDC or replace it with Quarkus OIDC.

Identity providers In the Quarkus Security framework, identity providers play a crucial role in authentication and authorization by verifying user identities.
Quarkus Security with Jakarta Persistence You can configure your application to use Jakarta Persistence to store users' identities.
Using security with JDBC Este guia demonstra como seu aplicativo Quarkus pode usar um banco de dados para armazenar suas identidades de usuário.
Using security with an LDAP realm This guide demonstrates how your Quarkus application can use an LDAP directory to store your user identities.
Using OpenID Connect (OIDC) and Keycloak to centralize authorization Learn how to enable bearer token authorization in your Quarkus application by using Keycloak Authorization Services for secure access to protected resources.
Using Keycloak Admin Client The Quarkus Keycloak Admin Client and its reactive twin support Keycloak Admin Client which can be used to configure a running Keycloak server.

Virtual thread support reference Este guia explica como se beneficiar das threads virtuais do Java 21+ no aplicativo Quarkus.
Use virtual threads in REST applications How to use virtual threads in a REST application
Quarkus virtual thread support for gRPC services Este guia explica como se beneficiar dos threads virtuais Java ao implementar um serviço gRPC.
Quarkus virtual thread support with Reactive Messaging This guide explains how to benefit from Java virtual threads when writing message processing applications in Quarkus.

Getting started with Reactive Saiba mais sobre como desenvolver aplicações reativas com o Quarkus.
Mutiny - Async for mere mortals Mutiny is an intuitive, reactive programming library.
Quarkus reactive architecture Saiba mais sobre a arquitetura reativa do Quarkus.
Usando rotas reativas Este guia demonstra como usar rotas reativas.
Reactive SQL clients Este guia aborda como usar os clientes SQL reativos no Quarkus.
Usando o Hibernate Reactive Hibernate Reactive is a reactive API for Hibernate ORM, supporting non-blocking database drivers and a reactive style of interaction with the database.
Hibernate Reativo Simplificado com Panache Camada ORM reativa simplificada baseada no Hibernate Reactive.
Utilizar o barramento de eventos Este guia explica como diferentes beans podem interagir usando o barramento de eventos.

Context propagation in Quarkus Saiba mais sobre como você pode passar informações contextuais com o SmallRye Context Propagation.
Duplicated context, context locals, asynchronous processing and propagation When using a traditional, blocking, and synchronous framework, processing of each request is performed in a dedicated thread.

Kubernetes extension Este guia aborda como implantar um aplicativo nativo no Kubernetes.
Deploying Quarkus applications to OpenShift This guide describes the deployment of Quarkus applications to OpenShift.
Deploying Quarkus applications to OpenShift in a single step This guide describes how to build and deploy a Quarkus application to OpenShift in a single step.
Using S2I to deploy Quarkus applications to OpenShift This guide describes how to build and deploy a Quarkus application on OpenShift by using Source-to-Image (S2I).
Deploying Quarkus Java applications to OpenShift by using a Docker build strategy This guide describes how to build and deploy a Quarkus application on OpenShift by using the Docker build strategy.
Deploying Quarkus applications compiled to native executables This guide describes how to deploy a Quarkus application to OpenShift compiled to native executables.
Implantando na nuvem do Microsoft Azure Deploy a Quarkus application to the Microsoft Azure cloud platform.
Deploying to Google Cloud Platform (GCP) Este guia explica como implantar um aplicativo Quarkus no Google Cloud.
Publicando na Heroku Implante seus aplicativos Quarkus na Heroku.
Automate Quarkus deployment with Ansible Build and deploy your Quarkus App using Ansible

AWS Lambda This guide explains how you can deploy Quarkus-based AWS Lambdas.
AWS Lambda com Quarkus REST, Undertow ou Reactive Routes This guide explains how you can deploy Vert.x Web, Servlet, or RESTEasy microservices as an AWS Lambda.
AWS Lambda SnapStart configuration This document explains how to optimize your AWS Lambda application for SnapStart
Google Cloud Functions (serverless) Este guia explica como você pode implantar o Google Cloud Functions baseado em Quarkus.
Google Cloud Functions (Serverless) with Quarkus REST, Undertow, or Reactive Routes Este guia explica como você pode implantar microsserviços Vert.x Web, Servlet ou RESTEasy como uma função do Google Cloud.
Azure Functions Integrate Quarkus with the Microsoft Azure functions that you have written.
Azure Functions with Quarkus REST, Undertow, or Reactive Routes Deploy Vert.x Web, Servlet, or RESTEasy microservices as a Microsoft Azure Function.
Funqy Este guia explica os conceitos básicos da estrutura Funqy, uma API de função de nuvem portátil simples entre provedores.
Funqy HTTP binding (standalone) Este guia explica a associação HTTP do Funqy.
Funqy AWS Lambda binding This guide explains Funqy's AWS Lambda binding.
Funqy HTTP Binding with AWS Lambda� This guide explains Funqy's AWS Lambda HTTP binding.
Funqy Google Cloud Functions Este guia explica a vinculação do Google Cloud Platform Functions da Funqy.
Funqy HTTP binding with Google Cloud Functions Este guia explica a vinculação HTTP do Google Cloud Platform Functions da Funqy.
Funqy HTTP binding with Azure Functions Use Funqy HTTP binding with Microsoft Azure Functions to deploy your serverless Quarkus applications.
Funqy Knative events binding Este guia explica a associação Knative Events do Funqy.

Kubernetes Client Este guia demonstra como usar o Fabric8 Kubernetes Client para interagir com seu cluster Kubernetes.
Kubernetes Config Use ConfigMaps como uma fonte de configuração para seus aplicativos Quarkus.
Dev Services para Kubernetes Start a Kubernetes API server automatically in dev and test modes.
Tarefas de inicialização This reference guide explains how to configure initialization tasks

Getting started with SmallRye Stork The essence of distributed systems resides in the interaction between services.
Usando o Stork com o Kubernetes This guide explains how to use Stork with Kubernetes for service discovery and load balancing.
Stork reference guide This guide is the companion to the Stork Getting Started Guide.
Automatic service registration with SmallRye Stork for Quarkus This guide explains how to enable automatic registration and deregistration of a Quarkus application using SmallRye Stork and Consul, with minimal or no configuration.
Implementing a custom Stork service registrar This guide explains how to implement a custom service registrar for SmallRye Stork and use it to programmatically register service instances at startup.

Management interface reference Management interface configuration
TLS registry reference TLS registry configuration and usage
Using Proxy Registry This guide explains how to use the Proxy Registry in your Quarkus application.

SmallRye Health Este guia demonstra como sua aplicação Quarkus pode utilizar a extensão SmallRye Health.
Application info endpoint Expose build, git, Java, and OS information via the /q/info endpoint.

Logging configuration Read about the use of logging API in Quarkus, configuring logging output, and using logging adapters to unify the output from other logging APIs.
Centralized log management (Graylog, Logstash, Fluentd) This guide explains how to centralize your logs with Graylog, Logstash or Fluentd.
Using OpenTelemetry Logging This guide explains how your Quarkus application can utilize OpenTelemetry Logging to provide centralised logging for interactive web applications.

Micrometer Metrics Use Micrometer to collect metrics produced by Quarkus, its extensions, and your application.
Collect metrics using Micrometer Create an application that uses the Micrometer metrics library to collect runtime, extension and application metrics and expose them as a Prometheus (OpenMetrics) endpoint.
Observabilidade no Quarkus An overview of the observability capabilities of Quarkus.
Usando OpenTelemetry This guide explains how your Quarkus application can utilize OpenTelemetry to provide observability for interactive web applications.
Using OpenTelemetry Tracing This guide explains how your Quarkus application can utilize OpenTelemetry Tracing to provide distributed tracing for interactive web applications.
Using OpenTelemetry Metrics This guide explains how your Quarkus application can utilize OpenTelemetry to provide metrics for interactive web applications.
Micrometer and OpenTelemetry extension Guide to send Micrometer data to OpenTelemetry.
Migrate from OpenTracing to OpenTelemetry tracing Migrate an application from OpenTracing to OpenTelemetry tracing in Quarkus 3.x.
Using JDK Flight Recorder This guide explains how JDK Flight Recorder (JFR) can be extended to provide additional insight into your Quarkus application.
Observability Dev Services Entry point for Observability DevServices
Observability Dev Services with Grafana OTel LGTM Instructions on how to use Grafana Otel LGTM

SmallRye Fault Tolerance Este guia demonstra como a sua aplicação Quarkus pode utilizar a especificação SmallRye Fault Tolerance através da extensão SmallRye Fault Tolerance.
Load shedding reference guide Load shedding is the practice of detecting service overload and rejecting requests.

Escrevendo serviços JSON REST JSON is now the lingua franca between microservices.

gRPC Ponto de entrada para tudo o que é gRPC.
Getting started with gRPC Este guia explica como começar a utilizar o gRPC na sua aplicação Quarkus.
Implementação de um serviço gRPC Este guia explica como implementar serviços gRPC na sua aplicação Quarkus.
Consumindo um serviço gRPC Este guia explica como consumir serviços gRPC na sua aplicação Quarkus.
Using gRPC CLI This page explains how to use gRPC CLI.
gRPC reference guide Learn how to configure gRPC server and clients.
gRPC code generation reference guide Learn how to configure gRPC code generation.
Deploying your gRPC service in Kubernetes This guide explains how to deploy your gRPC services in Quarkus to Kubernetes.
Quarkus virtual thread support for gRPC services Este guia explica como se beneficiar dos threads virtuais Java ao implementar um serviço gRPC.
Usando o xDS gRPC Esta página explica como habilitar o uso do gRPC xDS em sua aplicação Quarkus.

Command mode applications Este guia de referência explica como desenvolver aplicações de linha de comandos com o Quarkus.
Command mode with Picocli Simplifique a criação de aplicativos de linha de comando com a extensão Picocli.
Command mode with Aesh Develop command line applications with the Aesh extension.
Scripting with Quarkus Script fácil baseado em Quarkus com jbang.

Sending emails using SMTP Saiba mais sobre como você pode enviar e-mails de uma aplicação Quarkus com nosso cliente de e-mail reativo.
Mailer reference guide Este guia de referência explica com mais detalhes a configuração e o uso do Quarkus Mailer.

Scheduling periodic tasks Modern applications often need to run specific tasks periodically.
Scheduler reference guide Saiba mais sobre a extensão Scheduler.
Scheduling periodic tasks with Quartz Você precisa de suporte a clustering para suas tarefas agendadas? Este guia explica como usar a extensão Quartz para isso.

Qute templating engine Saiba mais sobre como você pode usar o modelo de modelagem em seus aplicativos com o mecanismo de modelo do Qute.
Qute reference guide Saiba tudo o que você precisa saber sobre o mecanismo de modelo do Qute.

Criar aplicações Quarkus com a interface de linha de comandos (CLI) do Quarkus Use a CLI do Quarkus para criar, compilar, executar e gerenciar extensões para projetos Quarkus.
Quarkus and Maven Develop and build your Quarkus application with Maven
Quarkus Maven plugin The Quarkus Maven Plugin builds the Quarkus applications, and provides helpers to launch dev mode or build native executables.
Quarkus and Gradle Develop and build your Quarkus application with Gradle
Build analytics This guide presents what build analytics is and how to configure it.
Atualizando projetos para a versão mais recente do Quarkus Learn how to upgrade your projects to the latest version of Quarkus

Quarkus extension for Spring DI API Embora você seja encorajado a usar anotações CDI para injeção, o Quarkus fornece uma camada de compatibilidade para injeção de dependência do Spring na forma da extensão spring-di.
Quarkus extension for Spring Web API While you are encouraged to use Jakarta REST annotations for defining REST endpoints, Quarkus provides a compatibility layer for Spring Web in the form of the spring-web extension.
Extension for Spring Data API Embora você seja encorajado a usar o Hibernate ORM com o Panache para sua camada de dados, o Quarkus fornece uma camada de compatibilidade para o Spring Data JPA na forma da extensão spring-data-jpa.
Quarkus extension for Spring Transaction API While you are encouraged to use Jakarta @Transactional directly, Quarkus provides a compatibility layer for Spring @Transactional in the form of the spring-tx extension.
Acessando propriedades da aplicação com a API Spring Boot Properties Use Spring Boot's @ConfigurationProperties in place of MicroProfile Config annotations
Quarkus extension for Spring Security API While you are encouraged to use the Quarkus Security layer to secure your applications, Quarkus provides a compatibility layer for Spring Security in the form of the spring-security extension.
Quarkus extension for Spring Cache API Embora você seja encorajado a usar a extensão Cache para seu cache no nível do aplicativo, o Quarkus fornece uma camada de compatibilidade para o Spring Cache na forma da extensão spring-cache.
Quarkus extension for Spring Scheduling API Embora você seja encorajado a usar as extensões Scheduler ou Quartz para agendar tarefas, o Quarkus fornece uma camada de compatibilidade para o Spring Scheduled na forma da extensão agendada para primavera.
Extensão para Spring Data REST O Spring Data REST simplifica a criação de aplicativos CRUD com base em nossa camada de compatibilidade Spring Data.
Reading properties from Spring Cloud Config Server O Quarkus fornece uma camada de compatibilidade para o Spring Cloud Config na forma da extensão spring-cloud-config-client.
Testing Spring-style applications in Quarkus Quarkus supports the @SpringBootTest annotation out of the box, letting Spring developers write tests in a familiar style while running on the Quarkus runtime.

Apache Camel no Quarkus Este guia aborda a integração de sistemas com o Apache Camel

Usando Kotlin Este guia explica como usar o Kotlin.

Quarkus reactive architecture Saiba mais sobre a arquitetura reativa do Quarkus.
Platform Saiba mais sobre o que chamamos de Plataforma no mundo Quarkus.
Class loading reference Saiba mais sobre a infraestrutura de carregamento de classes do Quarkus.
Quarkus modularity Quarkus modularity builds on JPMS to produce a complete and enhanced module graph for the application at build time.
Modularity SPI reference Reference for the build items that Quarkus extensions use to participate in Quarkus modularity.
Como é que o modo de desenvolvimento difere de uma aplicação de produção Como é que o modo de desenvolvimento difere de uma aplicação de produção
Quarkus extension registry Saiba mais sobre a noção de registro de extensão e como você pode usar o seu próprio.
Measuring performance Este guia explica como medir melhor o rastro de uma aplicação Quarkus.

Writing your own extension Quarkus extensions optimize your applications by pushing as much work as possible to the build operation.
Building my first extension Aprenda passo a passo como construir uma extensão simples.
Quarkus extension metadata Quarkus extensions are distributed as Maven JAR artifacts that application and other libraries may depend on.
Extension capabilities Como as capacidades são implementadas e utilizadas no Quarkus.
CDI integration guide Saiba como integrar sua extensão com o contêiner CDI do Quarkus.
Conditional extension dependencies Trigger the inclusion of additional extensions based on certain conditions.
Itens de Construção Explore todos os BuildItems que você pode consumir/produzir em suas extensões.
Interface do usuário do desenvolvedor Learn more about Dev UI
Extension codestart Provide users with initial code for extensions when generating Quarkus applications on code.quarkus.io and all the Quarkus tooling.
Writing a Dev Service Learn how to develop a Dev Service for your extension in order to replace an external service in development mode.
Dev MCP Learn more about Dev MCP
Agent MCP Learn more about the Quarkus Agent MCP server for AI coding agents
Dev Assistant Learn more about the Dev Assistant
Uma matriz de maturidade para extensões Quarkus Quarkus extensions can do a lot, or a little.
Frequently asked questions about writing extensions

Contribute to Quarkus documentation Contribute to the documentation by using the recommended diataxis content types, steps, workflow, and style guidance to ensure the content successfully renders on the Quarkus website portal.
Tipos de conteúdo da documentação Quarkus Quarkus documentation is structured into four distinct content types: concepts, how-tos, tutorials, and references.
Quarkus style and content guidelines Guidelines are provided to help you to contribute clear and consistent content that is also sourced in the required diataxis structure and composition of Quarkus documentation.
Creating a tutorial Create a new tutorial that guides users through creating, running, and testing a Quarkus application that uses annotations from an imaginary extension.

Definindo e executando regras de negócio com Drools Drools is the most used rule engine implementation in the Java ecosystem.

Quarkus is open. All dependencies of this project are available under the Apache Software License 2.0 or compatible license. CC by 3.0

This website was built with Roq on Quarkus, is hosted on GitHub Pages and is completely open source. If you want to make it better, fork the website and show us what you’ve got.

Navigation

Get Help

Languages

Quarkus is made of community projects

Copyright © Quarkus. All rights reserved. For details on our trademarks, please visit our Trademark Policy and Trademark List. Trademarks of third parties are owned by their respective holders and their mention here does not suggest any endorsement or association.