IMPORTANT: Developer documentation for the current main branch. This content is unreleased and may change before the next Polaris release. For stable user documentation, see the latest release docs.

Binary Distribution

Use this guide to quickly start running Polaris using the pre-built binary distribution.

Prerequisites🔗

Java SE 21 or later installed on your machine

Running🔗

Download the latest release and extract the binary distribution:

1POLARIS_VERSION=1.5.0
2curl -Lf https://downloads.apache.org/polaris/${POLARIS_VERSION}/polaris-bin-${POLARIS_VERSION}.tgz | tar xzf -
3cd polaris-bin-${POLARIS_VERSION}

Start the Polaris server:

1bin/server

The server will start and listen on http://localhost:8181 (main REST APIs) and http://localhost:8182 (management interface, for health checks and metrics).

Health and metrics endpoints are available under http://localhost:8182/q/health and http://localhost:8182/q/metrics respectively.

You can verify the server is running by checking the health endpoint:

1curl http://localhost:8182/q/health