Skip to main content

Download & Install

The fastest way to put anything on the internet.

JavaSDK

1

Get started with Java

Clone the ngrok Java SDK example:

git clone git@github.com:ngrok/java-sdk-example.git && cd java-sdk-example
2

Run your app

NGROK_AUTHTOKEN=<YOUR_AUTHTOKEN> mvn compile exec:java

Don’t have an authtoken? for a free account.

Open your ngrok URL in a browser to see it working!

You’re all set. What’s next?

1String tp = """2on_http_request:3	# redirect users to Google to log in4	- actions:5		- type: oauth6			config:7				provider: google8 9	# allow logins *only* from acme.com10	- expressions:11		- "!actions.ngrok.oauth.identity.email.endsWith('@acme.com')"12		actions:13		- type: deny14""";15 16var forwarder = session.httpEndpoint().trafficPolicy(tp).forward(new URL("http://localhost:8085"));

Inspect every detail of your traffic

Watch the flow in real time, then dig into the headers, body, latency, response, and more for every request.

Peruse the Java SDK quickstart

Follow along to embed ngrok into your app and use Traffic Policy for auth and traffic transformation.

Bring your own domain

Paid feature

Create a DNS CNAME record to use your own domain name for your endpoint URL.

1static void connectNgrok() throws IOException, InterruptedException {2		try (var session = Session.withAuthtokenFromEnv().connect()) {3				var forwarder = session.httpEndpoint()4						.domain("app.acme.com")5		}6}

Add load balancing

Endpoint Pooling lets you automatically distribute traffic among any number of replicas of your app.

1static void connectNgrok() throws IOException, InterruptedException {2		try (var session = Session.withAuthtokenFromEnv().connect()) {3				var forwarder = session.httpEndpoint()4						.poolingEnabled(true)5		}6}