# java-nats-server-runner

**Repository Path**: mirrors_brimworks/java-nats-server-runner

## Basic Information

- **Project Name**: java-nats-server-runner
- **Description**: Run the Nats Server From your Java code.
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-06-17
- **Last Updated**: 2026-02-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

![NATS](src/main/javadoc/images/large-logo.png)

# Java Nats Server Runner

Run the [NATS messaging system](https://nats.io) Server from your Java code. 

[![License Apache 2](https://img.shields.io/badge/License-Apache2-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)
[![Maven Central](https://maven-badges.herokuapp.com/maven-central/io.nats/jnats-server-runner/badge.svg)](https://maven-badges.herokuapp.com/maven-central/io.nats/jnats-server-runner)
[![Javadoc](http://javadoc.io/badge/io.nats/jnats-server-runner.svg?branch=main)](http://javadoc.io/doc/io.nats/jnats-server-runner?branch=main)
[![Release Badge](https://github.com/nats-io/java-nats-server-runner/actions/workflows/build.yml/badge.svg?event=push)](https://github.com/nats-io/java-nats-server-runner/actions/workflows/build.yml)

Useful for running unit or integration tests on the localhost.

By default, the server must be in your path under the name `nats-server`
or you must set the `nats_server_path` environment variable.

```java
try (NatsServerRunner server = new NatsServerRunner()) {
    System.out.println("Server running on port: " + server.getPort())

    Connection c = Nats.connect(server.getURI());
    
    ...
}
```

## License

Unless otherwise noted, the NATS source files are distributed
under the Apache Version 2.0 license found in the LICENSE file.