# AxonIQ Axon Server Proxy

## License Summary

Licensed under the AXONIQ TERMS OF SERVICE,
Version 29 April 2026 (the "License");

The software is available for evaluation use without registration.
Continued use beyond the evaluation period requires registration
and a commercial license. See the License for the specific language
governing permissions and limitations under the License.
You may not use this file except in compliance with the License.

You may obtain a copy of the License at:
https://www.axoniq.io/legal/terms-of-service

For licensing information and to register, visit:
https://www.axoniq.io/pricing

## Requirements

- Java 21 or later

## Running

```bash
java -jar axonserver-proxy-*.jar
```

## Configuration

Place configuration files next to the JAR, or use environment variables. Key properties are prefixed with `proxy.*`.

## Ports

| Port | Protocol | Description     |
|------|----------|-----------------|
| 9999 | gRPC     | Main Proxy port |
| 8080 | HTTP     | Monitoring port |

## Docker

Docker images are available as:

- `docker.axoniq.io/axoniq/axonserver-proxy:<version>` — runs as root
- `docker.axoniq.io/axoniq/axonserver-proxy:<version>-nonroot` — runs as non-root user `axonserver` (uid 1001)

### Example

```bash
docker run -p 8080:8080 -p 9999:9999 \
  docker.axoniq.io/axoniq/axonserver-proxy:<version>-nonroot
```
