Forgejo

You can connect Stretchy to any Forgejo 15 (or newer) instance, including Codeberg, and run Forgejo Actions on the machines of your choice.

If not mentioned explicitly, the steps for Forgejo and Codeberg are identical.

Connecting Stretchy to Forgejo

Connecting Stretchy with Forgejo is a two-step process:

If you want to connect Stretchy to a Forgejo organization:

In Forgejo, click on your user profile, then on Settings, Applications, and finally on the button New access token.
Enter a memorable Token name.
Choose the option All (public, private, and limited) when asked for Repository and Organization Access.
Select the permissions organization (write), and repository (read).
Note the displayed Access token.

If you want to connect Stretchy to a Forgejo user:

In Forgejo, click on your user profile, then on Settings, Applications, and finally on the button New access token.
Enter a memorable Token name.
Choose the option All (public, private, and limited) when asked for Repository and Organization Access.
Select the permissions and repository (read), and user (write).
Note the displayed Access token.

Go to Connections, click on Add connection and select the connection type Forgejo. Follow the instructions displayed by the web interface.

Go to Projects, click on Add project and select the project type Forgejo.
Select the previously created connection and select a Forgejo repository from the dropdown before clicking on Create.

Stretchy will ignore jobs in Forgejo repositories without a corresponding project in Stretchy.

Stretchy Orchestrator provides an assistant to create a label combination that you can copy into your Forgejo Actions workflow:

Go to Projects and click on Set up next to the project whose Forgejo Actions jobs should be routed to Stretchy.
Select one flavour and one image.
Copy the generated label combination into the jobs.<job_id>.runs-on stanza of your Forgejo Actions workflow.

The label assistant will automatically add any required labels.