# `@recaptime-dev/phorge-extensions` - Phorge Extensions

Home of in-house and community extensions for Phorge in one place.

## Repository URLs

Canonical repoisotry is [hosted at our own Phorge instance](https://issues.recaptime.dev/source/phorge-extensions), with mirrors avilable at:

* GitLab.com: https://gitlab.com/recaptime-dev/infra/pgorge-extensions
* Tangled: httpd://tangled.org/recaptime.dev/phorge-extensions

## Usage

### Via Docker

1. Clone the extensions repo to `~/extensions` directory in the `PHORGE_VCS_USER`'s home directory.

```dockerfile
FROM ghcr.io/recaptime-dev/infra/phorge:nightly

WORKDIR /srv/phorge
# If our Phorge instance is down, use the GitLab or Tangled mirro as repo URLs.
RUN git clone https://issues.recaptime.dev/source/phorge-extensions ./extensions
    
```

2. At container start or while within the container shell (vis `docker [exec|compose exec] phorge -u $PHORGE_VCS_USER -it bash`, run the following command ([see Miraheze's Phorge ibstance config](https://github.com/miraheze/puppet/blob/7d3c9f757c5ea57d2268fbea196e0491702b48b8/modules/phorge/data/config.yaml#L2) for context):

```
/srv/phorge/phorge/bin/config set load-libraries '["/srv/phorge/extensions"]'
```

3. Config changes should be apply immediately once validated. Refresh at will.

## License

* Original code at `src/recaptime-dev`: Mozilla Public License 2.0 and AGPL-3.0 (or later)
* Third-party code at `src/thirdparty`: see respective `LICENSE` file.