create-release

Create a Forgejo release from a workflow run. This action will create a release with a tag and name. It is intended to be run from a workflow on a runner that has access to the repository.

Quick example

- name: Create Release
  uses: https://git.fucktheforce.de/actions/create-release@master
  with:
    tag: 2026-02-16
    token: ${{ secrets.WRITE_REPO_TOKEN }}

Inputs

Name	Required	Default	Description
server_url	no	(runtime instance)	Base URL of the Forgejo instance to target. If omitted the action uses the runner’s instance value.
repository	no	(current repository)	Target repository in owner/name form. Omit to use the current repository.
tag	yes	-	Tag name for the release. in case of non-draft version a tag will be created.
token	yes	-	A personal access token used to authenticate the upload. Store this token as a secret and pass it here. the token needs write access to the repository.
release_name	no	-	The name of the release, if not set the tag will be used.
release_description	no	-	The description of the release.
release_draft	no	"false"	"true" or "false". If "true", the action will mark the release as draft.
prerelease	no	"false"	"true" or "false". If "true", the action will mark the release as prerelease.
hide_archive_links	no	"false"	"true" or "false". If "true", the action will hide the archive links.
target_commitish	no	"master"	https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-commit-ishalsocommittish.

Examples

Create release in the same repository

name: Release Upload
on:
  push:
    tags:
      - "v*"

jobs:
  upload:
    runs-on: docker
    steps:
      - name: Create Release
        uses: https://git.fucktheforce.de/actions/create-release@master
        with:
          tag: ${{ github.ref_name }}
          release_description: "Super duper release"
          token: ${{ secrets.PERSONAL_ACCESS_TOKEN }}