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. This needs Corepack 0.34.5 or later, which Node.js includes from 20.20.1, 22.22.1, and 24.12 in those release lines. Node.js 25 and later don't include Corepack. On any other Node.js version, run npm install -g [email protected] before corepack enable.

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