# setup-forgejo

<!-- action-docs-description -->
## Description

Setup Forgejo and a runner
<!-- action-docs-description -->

It can only be run on the `self-hosted` platform, running on a host with LXC installed.

<!-- action-docs-inputs -->
## Inputs

| parameter | description | required | default |
| --- | --- | --- | --- |
| image | Container image | `false` | codeberg.org/forgejo/forgejo |
| image-version | Container image version | `false` | 1.19 |
| user | Administrator user name | `false` | root |
| password | Administrator password | `false` | admin1234 |
| runner | Runner git repository | `false` | https://code.forgejo.org/fogejo/runner |
| runner-version | Runner version | `false` | v1.4.1 |
<!-- action-docs-inputs -->


<!-- action-docs-outputs -->
## Outputs

| parameter | description |
| --- | --- |
| url | URL of the Forgejo instance |
| host-port | Host and port of the Forgejo instance, e.g 172.0.17.2:3000 |
| token | Administrator application token with all,sudo scopes |
| runner-logs | Filename of the Forgejo runner logs |
<!-- action-docs-outputs -->

## Example

```
name: Setup Forgejo
on: [push]
jobs:
  setup-forgejo:
    runs-on: self-hosted
    steps:
      - uses: actions/checkout@v3
      - id: forgejo
        uses: setup-forgejo@v1
        with:
          image-version: 1.19
      - run: |
          curl ${{ steps.forgejo.outputs.url }}/api/forgejo/v1/version | grep 1.19

```

## Hacking

* Update the README from the action file with https://github.com/npalm/action-docs `action-docs --update-readme`