New Ory Agent Security is now live! Claim your complimentary test drive. Get Started!

Skip to main content

Local Development

This guide will help you to setup and run Ory Polis in development mode.

Clone the repo​

git clone https://github.com/ory/polis.git

cd polis

Install dependencies​

Ory Polis uses pnpm. Run corepack enable once to get the pnpm version the repository pins, then install the Node dependencies.

pnpm install

Setup environment variables​

cp .env.example .env

Please refer to environment variables to read on setting environment variables.

Setup the database​

Run the following command to create database instances for the local development. Make sure you have Docker installed on your machine.

pnpm run dev-dbs

Start the development server​

Start the development server by running the following command.

pnpm run dev

Testing Ory Polis in your local environment​

The Ory Polis service can be accessed locally using the following URL

http://localhost:5225

You can visit the following URL to see if the Ory Polis was started successfully!

http://localhost:5225/api/health

Ory Network

The largest Identity and Access Management network in the world. So you can get back to building your business.

Sign up for free