line/armeria

View on GitHub

Your go-to microservice framework for any situation, from the creator of Netty et al. You can build any type of microservice leveraging your favorite technologies, including gRPC, Thrift, Kotlin, Retrofit, Reactive Streams, Spring Boot and Dropwizard.

Stars: 5.1k
Forks: 1k
Open beginner issues: 0
Indexed issues: 623
Avg merge: 2d 19h
Merged PRs (30d): 31

Dominant language: Java
License: Apache-2.0
Last GitHub push: Sep 16, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: good first issue

Beginner friendly Everything

Open All

623 open issues indexed

Support OpenSAML 5 Open

dependencies

Difficulty 4/5 3-5 days Newbie friendliness 35/100

line/armeria#6969 · 1 comment · Opened Sep 15, 2026
gRPC server may invoke onReady() reentrantly on the non-blocking path Open

defect

Difficulty 4/5 3-5 days Newbie friendliness 52/100

line/armeria#6938 · 6 comments · Opened Sep 1, 2026
Provide a way to mask sensitive query parameters in request logs Open

new feature

Difficulty 3/5 1-2 days Newbie friendliness 65/100

line/armeria#6919 · 1 comment · 1 reaction · Opened Aug 13, 2026
DEADLINE_EXCEEDED description reports a smaller timeout than the configured responseTimeoutMillis when RetryingClient is used Open

Difficulty 3/5 1-2 days Newbie friendliness 72/100

line/armeria#6894 · 1 comment · Opened Aug 3, 2026
Annotation-based MCP service Open

new feature

Difficulty 5/5 Over a week Newbie friendliness 38/100

line/armeria#6873 · 4 comments · Opened Jul 24, 2026
WebSocketClient.connect() throws IllegalStateException: Should call init(endpoint) with an async EndpointGroup Open

Difficulty 3/5 1-2 days Newbie friendliness 68/100

line/armeria#6839 · 1 comment · 1 reaction · Opened Jul 2, 2026
Leak in KubernetesEndpointGroup Open

Difficulty 4/5 3-5 days Newbie friendliness 45/100

line/armeria#6805 · 1 comment · Opened Jun 11, 2026
Test failure: `com.linecorp.armeria.server.HttpServerTlsCorruptionTest.test()` Open

cleanup

Difficulty 3/5 1-2 days Newbie friendliness 38/100

line/armeria#6775 · Opened May 21, 2026
Use full method signature for docstring keys Open

defect

line/armeria#6619 · 1 comment · 1 reaction · 1 assignee · Opened Feb 3, 2026
Test failure: `io.modelcontextprotocol.ArmeriaStreamableIntegrationTests.httpclient : testToolListChangeHandlingSuccess(String)` Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

line/armeria#6593 · Opened Jan 20, 2026
Test failure: `com.linecorp.armeria.server.ServerTest.unsuccessfulStartupTerminatesBossGroup()` Open

Difficulty 3/5 1-2 days Newbie friendliness 42/100

line/armeria#6584 · Opened Jan 7, 2026
Test failure: `io.modelcontextprotocol.ArmeriaStreamableIntegrationTests.httpclient : testRootsServerCloseWithActiveSubscription(String)` Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

line/armeria#6579 · Opened Jan 5, 2026
Test failure: `com.linecorp.armeria.client.ConnectionPoolKeepAliveTest.[1] protocol=h1c` Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

line/armeria#6578 · Opened Jan 5, 2026
Move content previewing and encoding/decoding service to server/service option Open

new feature

Difficulty 5/5 Over a week Newbie friendliness 30/100

line/armeria#6577 · 3 comments · 1 reaction · Opened Jan 5, 2026
Test failure: `com.linecorp.armeria.server.ServerTest.defaultStartStopExecutor()` Open

cleanup

Difficulty 3/5 1-2 days Newbie friendliness 35/100

line/armeria#6544 · Opened Dec 9, 2025
Test failure: `com.linecorp.armeria.server.PortBasedVirtualHostTest.testVirtualHostNameWithoutPort()` Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

line/armeria#6530 · Opened Dec 1, 2025
Test failure: `com.linecorp.armeria.xds.DynamicResourcesTest.basicCase()` Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

line/armeria#6529 · Opened Dec 1, 2025
Test failure: `io.modelcontextprotocol.ArmeriaStreamableIntegrationTests.httpclient : testRootsSuccess(String)` Open

Difficulty 3/5 1-2 days Newbie friendliness 30/100

line/armeria#6520 · Opened Nov 26, 2025
sun.misc.Unsafe::arrayBaseOffset has been called by com.linecorp.armeria.internal.shaded.jctools.maps.NonBlockingHashMap Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

line/armeria#6508 · 1 comment · Opened Nov 20, 2025
Test failure: `com.linecorp.armeria.client.endpoint.healthcheck.HealthCheckedEndpointGroupTest.cacheReflectsAttributeChanges()` Open

cleanup

Difficulty 3/5 1-2 days Newbie friendliness 35/100

line/armeria#6482 · Opened Nov 3, 2025
Test failure: `com.linecorp.armeria.server.HttpServerRequestTimeoutTest.accessLogIsWrittenRightAwayAfterResponseIsSent()` Open

cleanup

Difficulty 3/5 1-2 days Newbie friendliness 45/100

line/armeria#6480 · Opened Nov 3, 2025
Test failure: `com.linecorp.armeria.server.athenz.AthenzPolicyLoaderTest.[1] jwsPolicySupport=true` Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

line/armeria#6452 · Opened Oct 23, 2025
DNS resolution happens before connection pool lookup Open

Difficulty 4/5 3-5 days Newbie friendliness 38/100

line/armeria#6444 · 6 comments · 1 reaction · Opened Oct 16, 2025
Test failure: `com.linecorp.armeria.client.endpoint.healthcheck.HealthCheckedEndpointGroupLongPollingPingTest.ping` Open

cleanup

Difficulty 3/5 1-2 days Newbie friendliness 38/100

line/armeria#6406 · Opened Sep 21, 2025
Use `RequestLog#currentAttempt` to determine the number of retry attempts Open

Difficulty 3/5 1-2 days Newbie friendliness 62/100

line/armeria#6397 · 1 comment · Opened Sep 11, 2025
Test failure: `com.linecorp.armeria.xds.it.RetryTest.rateLimitedBackoff` Open

cleanup

Difficulty 3/5 1-2 days Newbie friendliness 42/100

line/armeria#6394 · Opened Sep 9, 2025
Support for HTTP Range Request Open

new feature

Difficulty 4/5 3-5 days Newbie friendliness 35/100

line/armeria#6392 · 3 comments · Opened Sep 8, 2025
Improve HTTP/2 GOAWAY handling to close idle connections early during graceful shutdown Open

discussion

Difficulty 4/5 3-5 days Newbie friendliness 42/100

line/armeria#6388 · 1 comment · Opened Sep 3, 2025
Add name to ClientFactory Open

Difficulty 3/5 1-2 days Newbie friendliness 38/100

line/armeria#6387 · Opened Sep 3, 2025
Missing `Allow` header in HTTP response with `405` (MethodNotAllowed) Open

defect

Difficulty 2/5 1-3 hours Newbie friendliness 48/100

line/armeria#6386 · 1 comment · Opened Sep 3, 2025
Retrofit client can’t have responseTimeout set longer than 15 seconds Open

defect

Difficulty 3/5 1-2 days Newbie friendliness 52/100

line/armeria#6385 · 3 comments · Opened Sep 3, 2025
Expose client request metrics Open

new feature

Difficulty 5/5 Over a week Newbie friendliness 35/100

line/armeria#6372 · 5 comments · Opened Aug 27, 2025
Allow customizing `ThriftFieldMaskerSelectorProvider` Open

new feature

Difficulty 4/5 3-5 days Newbie friendliness 35/100

line/armeria#6343 · 2 comments · Opened Aug 6, 2025
Support for inheritance and polymorphism in DocService Open

priority: P2

Difficulty 5/5 Over a week Newbie friendliness 25/100

line/armeria#6313 · 2 comments · Opened Jul 17, 2025
Unable to retrieve original exception when RequestTimeoutException occurs before response in Thrift service Open

improvement

Difficulty 4/5 3-5 days Newbie friendliness 48/100

line/armeria#6297 · 1 comment · Opened Jun 26, 2025
Implement JsonRpcService Open

new feature

Difficulty 5/5 Over a week Newbie friendliness 25/100

line/armeria#6286 · 7 comments · Opened Jun 20, 2025
Survey how metrics/traces/logs can be exported via OTLP with Armeria Open

documentation priority: P1

Difficulty 5/5 Over a week Newbie friendliness 25/100

line/armeria#6281 · 4 comments · 1 reaction · Opened Jun 13, 2025
Replace custom netty event loop metrics with micrometer provided metrics Open

improvement

Difficulty 4/5 3-5 days Newbie friendliness 35/100

line/armeria#6274 · 4 comments · Opened Jun 8, 2025
Retry GOAWAY frame without RetryingClient Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

line/armeria#6263 · 1 comment · 1 reaction · Opened Jun 3, 2025
Armeria and OpenApi when using armeria-spring-boot3-webflux-starter Open

defect priority: P3

Difficulty 3/5 1-2 days Newbie friendliness 45/100

line/armeria#6249 · Opened May 20, 2025
Provide a way for users to extract the SSL key for client-side Open

new feature priority: P3

Difficulty 5/5 Over a week Newbie friendliness 35/100

line/armeria#6247 · 1 reaction · Opened May 20, 2025
Enable creating a `RetryConfigMapping` on a per method, path, or host basis Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

line/armeria#6242 · 1 comment · Opened May 17, 2025
Ensure gRPC serializes/deserializes requests/responses from blocking executors if available Open

defect priority: P2

Difficulty 4/5 3-5 days Newbie friendliness 48/100

line/armeria#6241 · 4 comments · Opened May 16, 2025
Support custom timeout strategies in StreamMessage.timeout(), with built-in support for a token-bucket timeout-limiting strategy Open

Difficulty 5/5 Over a week Newbie friendliness 30/100

line/armeria#6237 · Opened May 10, 2025
Make SessionProtocolNegotiationCache behavior configurable Open

improvement

Difficulty 5/5 Over a week Newbie friendliness 30/100

line/armeria#6234 · Opened May 9, 2025
Use Spotless + Prettier Java Open

cleanup priority: P1

Difficulty 4/5 3-5 days Newbie friendliness 35/100

line/armeria#6226 · 1 reaction · Opened Apr 29, 2025
Client gets ClosedSessionException when using HTTP/1 Open

defect priority: P0

Difficulty 4/5 3-5 days Newbie friendliness 25/100

line/armeria#6225 · 13 comments · 1 reaction · Opened Apr 28, 2025
Expose response headers in `DocService` Open

new feature

Difficulty 3/5 1-2 days Newbie friendliness 45/100

line/armeria#6187 · 3 comments · Opened Mar 31, 2025
Support for MCP (Model Context Protocol) Open

new feature priority: P2

Difficulty 5/5 Over a week Newbie friendliness 30/100

line/armeria#6179 · 11 comments · 5 reactions · Opened Mar 28, 2025
Add a public API for creating and configuring the default `AddressResolverGroup` and `AddressResolver`. Open

new feature

Difficulty 5/5 Over a week Newbie friendliness 35/100

line/armeria#6176 · Opened Mar 28, 2025

line/armeria

Get new issues in your inbox