ory-local-dev

Manage Docker containers for a local Ory authentication stack.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/ory/codex-plugins --skill ory-local-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ory-local-dev
Source: https://github.com/ory/codex-plugins/tree/main/plugins/ory-codex/skills/ory-local-dev
Command: npx skills add https://github.com/ory/codex-plugins --skill ory-local-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill unit provides a local environment for developing, prototyping, or testing authentication flows without requiring an Ory Network project.

Core Features & Use Cases

  • Local Stack: Starts Kratos, Keto, Hydra, and a gateway on port 4000.
  • Command Management: Executes ory-local-up and ory-local-down commands.
  • Docker Compose: Uses Docker Compose to manage the local stack.
  • Data Management: Seeds a test identity, session, and permission tuples upon startup.
  • Use Case: Ideal for developing, testing, or prototyping authentication flows and applications locally.

Quick Start

Run the command 'npx -y -p @ory/codex ory-codex local up' to start the local Ory stack.

Frequently Asked Questions about ory-local-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a local Ory stack for offline authentication development?

To run a local Ory stack for offline authentication development, execute the command 'npx -y -p @ory/codex ory-codex local up' to initialize Kratos, Keto, Hydra, and a gateway on port 4000 using Docker Compose.

Do I need an Ory Network project to test authentication workflows locally?

No, you do not need an Ory Network project to test authentication workflows locally. This environment uses Docker Compose to run Kratos, Keto, and Hydra offline for developing and prototyping identity flows.

What is the best way to test Ory identity management without a remote connection?

The best way to test Ory identity management without a remote connection is using a local stack that seeds a test identity, session, and permission tuples upon startup, allowing offline prototyping of authentication flows.

How does Docker Compose manage the local Ory environment during testing?

Docker Compose manages the local Ory environment by coordinating Docker containers for the Ory stack. It executes initialization and shutdown commands, specifically 'ory-local-up' and 'ory-local-down', to control the lifecycle.

How do I shut down the local Ory stack after testing authentication flows?

To shut down the local Ory stack after testing authentication flows, execute the 'ory-local-down' command to stop and remove the Docker containers managing Kratos, Keto, and Hydra.