PHPackages                             der-monozukurist/ory-auth-server - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. der-monozukurist/ory-auth-server

ActiveLibrary

der-monozukurist/ory-auth-server
================================

Composer package for local Ory Kratos and Hydra development environment

01Shell

Since Oct 5Pushed 7mo agoCompare

[ Source](https://github.com/DerMonozukurist/ory-auth-server)[ Packagist](https://packagist.org/packages/der-monozukurist/ory-auth-server)[ RSS](/packages/der-monozukurist-ory-auth-server/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Ory Auth Server
===============

[](#ory-auth-server)

This project provides a ready-to-run authentication and authorization server. With a single command, it spins up a fully integrated environment that lets you build, prototype, and test identity, login, consent, and token-based access flows end-to-end without needing to wire up cloud services or bespoke infrastructure.

Installation
------------

[](#installation)

- Clone the project (or require it via Composer if you’re integrating with another project).
- Ensure the environment file is set:
    - A default `.env` file is provided in the project root; review and adjust values (especially secrets) before starting.

Quick Start
-----------

[](#quick-start)

1. Adjust secrets in `.env` for local use (do not use defaults in production).
2. Start the stack:
    - Using Docker Compose:
        - docker compose up -d
3. Access the services:
    - Kratos Public API:
    - Kratos Admin API:
    - Kratos Self-service UI:
    - Hydra Public API (OAuth2/OIDC):
    - Hydra Admin API:
    - Postgres: localhost:5432

### Data persistence:

[](#data-persistence)

- By default, PostgreSQL data persists under `./var/postgres`

Configuration
-------------

[](#configuration)

- Central configuration is via the `.env` file in the project root. Key groups:
    - PostgreSQL: `OAS_POSTGRES_*`
    - Kratos: `OAS_KRATOS_*` and UI-related secrets (`OAS_UI_*`)
    - Hydra: `OAS_HYDRA_*`
- Service configs are mounted from:
    - `config/ory-auth-server/kratos/kratos.yml`
    - `config/ory-auth-server/kratos/identity.schema.json`
    - `config/ory-auth-server/hydra/hydra.yml`

You can customize ports, log levels, and service URLs through `.env`. The Compose file reads those values when starting the containers.

### Docker compose override

[](#docker-compose-override)

- The suggested way to override the default docker compose configuration is to create a `docker-compose.override.yaml` file in the project root.

Verify
------

[](#verify)

1. Check if all containers are running: ```
    $ docker ps
    ```

    All services should show (`postgres`, `kratos`, `hydra`, `kratos-selfservice-ui`) should show **"Up"** status.
2. Verify Kratos API is responding ```
    $ curl http://localhost:4433/health/alive
    {"status":"ok"}
    ```
3. Verify Hydra API is responding ```
    $ curl http://localhost:4444/health/alive
    {"status":"ok"}
    ```
4. Check that OAuth 2.0 discovery works ```
    curl http://localhost:4444/.well-known/openid-configuration
    ```

    You should see a JSON response suggesting that the server is running.
5. Test Kratos Self-Service UI (browser)
    In a browser, navigate to . You should see a page indicating that everything is working correctly.

Common Tasks
------------

[](#common-tasks)

- Start services: docker compose up -d
- Viewing logs:
    - `docker compose logs -f kratos`
    - `docker compose logs -f hydra`
    - `docker compose logs -f postgres`
    - `docker compose logs -f` (all services)
- Stop services: `docker compose down`
- Recreate (fresh DB): `docker compose down -v` (removes volumes, including Postgres data)

Security Notes
--------------

[](#security-notes)

- Change all secrets in `.env` before use (e.g., OAS\_HYDRA\_SECRETS\_SYSTEM, OAS\_UI\_\* secrets).
- The stack runs with development defaults and should not be used as-is in production.

License
-------

[](#license)

MIT License. See [LICENSE.txt](./LICENSE.txt) for details.

Development guidelines
----------------------

[](#development-guidelines)

- See [doc/development-guidelines.md](./doc/development-guidelines.md)

###  Health Score

16

—

LowBetter than 5% of packages

Maintenance45

Moderate activity, may be stable

Popularity1

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity13

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/7ad2491f622d745bd5e74bbdb7f875f02434aa8990cf1a9e951cf18e79813af0?d=identicon)[DerMonozukurist](/maintainers/DerMonozukurist)

---

Top Contributors

[![DerMonozukurist](https://avatars.githubusercontent.com/u/5939615?v=4)](https://github.com/DerMonozukurist "DerMonozukurist (7 commits)")

### Embed Badge

![Health badge](/badges/der-monozukurist-ory-auth-server/health.svg)

```
[![Health](https://phpackages.com/badges/der-monozukurist-ory-auth-server/health.svg)](https://phpackages.com/packages/der-monozukurist-ory-auth-server)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)