PHPackages                             hiraeth/runner - 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. [DevOps & Deployment](/categories/devops)
4. /
5. hiraeth/runner

ActiveOpus-package[DevOps & Deployment](/categories/devops)

hiraeth/runner
==============

Run your Hiraeth application with Docker and FrankenPHP

3.0-beta(1y ago)038MITPHP

Since Apr 6Pushed 1y ago1 watchersCompare

[ Source](https://github.com/hiraeth-php/runner)[ Packagist](https://packagist.org/packages/hiraeth/runner)[ RSS](/packages/hiraeth-runner/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (3)Versions (2)Used By (0)

Runner
======

[](#runner)

Runner is a way to run your Hiraeth application using Docker and FrankenPHP. The only pre-requisite should be a relatively modern version of Docker.

Install
-------

[](#install)

In your project root:

```
composer require hiraeth/runner

```

Basic Usage
-----------

[](#basic-usage)

```
cd runner
docker compose up

```

Executing this will build FrankenPHP along with a recent version of PHP. It should be noted that out of the box only a minimal set of PHP extensions are provided/built for the PHP image. To add extensions, from the `runner` directory, simply:

```
touch extensions/

```

For example:

```
touch extensions/sqlite3

```

Then re-run with:

```
docker compose up --build

```

Caddy
-----

[](#caddy)

Runner is powered by Caddy, if you need additional plugins you can add them to the `build.args` file as `--with` arguments for the `xcaddy` build step. Similarly you would want to re-run with the `--build` option. You can modify the Caddyfile in the `caddy` sub-directory. By default tls will be enabled with `internal` and all ports will be opened on all interfaces.

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance46

Moderate activity, may be stable

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity23

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.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

407d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4ab2b91daf2aa6e4c7f98f785a3135daa3e9998bd7021d89df05a374e28ecde5?d=identicon)[mattsah](/maintainers/mattsah)

---

Top Contributors

[![mattsah](https://avatars.githubusercontent.com/u/586346?v=4)](https://github.com/mattsah "mattsah (11 commits)")

### Embed Badge

![Health badge](/badges/hiraeth-runner/health.svg)

```
[![Health](https://phpackages.com/badges/hiraeth-runner/health.svg)](https://phpackages.com/packages/hiraeth-runner)
```

###  Alternatives

[deployer/deployer

Deployment Tool

11.0k25.4M207](/packages/deployer-deployer)[appwrite/server-ce

End to end backend server for frontend and mobile apps.

55.3k84.2k](/packages/appwrite-server-ce)[pragmarx/health

Laravel Server & App Health Monitor and Notifier

2.0k1.0M2](/packages/pragmarx-health)[felixfbecker/language-server-protocol

PHP classes for the Language Server Protocol

22476.7M6](/packages/felixfbecker-language-server-protocol)[heroku/heroku-buildpack-php

Toolkit for starting a PHP application locally, with or without foreman, using the same config for PHP and Apache2/Nginx as on Heroku

8161.3M10](/packages/heroku-heroku-buildpack-php)[tiamo/phpas2

PHPAS2 is a php-based implementation of the EDIINT AS2 standard

4674.7k](/packages/tiamo-phpas2)

PHPackages © 2026

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