forgejo/docs
32
45
Fork
You've already forked docs
204

Document permission differences with GitHub Actions #1673

Open
AdamWill wants to merge 1 commit from AdamWill/docs:github-actions-permissions into next
pull from: AdamWill/docs:github-actions-permissions
merge into: forgejo:next
forgejo:next
forgejo:v14.0
forgejo:cli
forgejo:v13.0
forgejo:v11.0
forgejo:v12.0
forgejo:bp-v12.0-a6c8557
forgejo:v7.0
forgejo:v10.0
forgejo:v9.0
forgejo:v8.0
forgejo:v1.21
forgejo:v1.20
forgejo:v1.19
First-time contributor
Copy link

Experimenting with Forgejo Actions this week, I've found several
differences with GitHub Actions in terms of token permissions and
access controls. This documents them in the "Known list of
differences".

Signed-off-by: Adam Williamson awilliam@redhat.com

Experimenting with Forgejo Actions this week, I've found several differences with GitHub Actions in terms of token permissions and access controls. This documents them in the "Known list of differences". Signed-off-by: Adam Williamson <awilliam@redhat.com>
Document permission differences with GitHub Actions
All checks were successful
pr / preview (pull_request_target) Successful in 1m34s
4c05a6f296
Experimenting with Forgejo Actions this week, I've found several
differences with GitHub Actions in terms of token permissions and
access controls. This documents them in the "Known list of
differences".
Signed-off-by: Adam Williamson <awilliam@redhat.com>
Collaborator
Copy link
Preview ready: https://forgejo.codeberg.page/@docs_pull_1673/
AdamWill force-pushed github-actions-permissions from 4c05a6f296
All checks were successful
pr / preview (pull_request_target) Successful in 1m34s
to 411679e3b1
All checks were successful
pr / preview (pull_request_target) Successful in 1m21s
2026年01月08日 23:02:20 +01:00
Compare
Author
First-time contributor
Copy link

Note I did not cover forgejo/forgejo#10733 in this, because that seems clearly like a bug to me rather than intended (and thus documentable) behavior. But if that is not fixed, or if we only fix it on future releases, the true description would be:

"...The automatically-generated FORGEJO_TOKEN secret has full read/write permissions for all workflows except those triggered by the pull_request or pull_request_target events for a pull request from a forked repository. For that case, the token has read permissions only..."

Note I did not cover https://codeberg.org/forgejo/forgejo/issues/10733 in this, because that seems clearly like a bug to me rather than intended (and thus documentable) behavior. But if that is not fixed, or if we only fix it on future releases, the true description would be: "...The automatically-generated `FORGEJO_TOKEN` secret has full read/write permissions for all workflows except those triggered by the `pull_request` or `pull_request_target` events for a pull request from a forked repository. For that case, the token has read permissions only..."
Author
First-time contributor
Copy link

Hmm, I don't see my change in the preview. Is the preview generation broken? I can't see how it would be possible for the changes to simply not appear at all.

Hmm, I don't see my change in the preview. Is the preview generation broken? I can't see how it would be possible for the changes to simply not appear at all.

When checking the preview, ensure that you change the "Docs" dropdown to "Next" -- eg. https://forgejo.codeberg.page/@docs_pull_1673/docs/next/user/actions/github-actions/

When checking the preview, ensure that you change the "Docs" dropdown to "Next" -- eg. https://forgejo.codeberg.page/@docs_pull_1673/docs/next/user/actions/github-actions/
All checks were successful
pr / preview (pull_request_target) Successful in 1m21s
Required
Details
This pull request doesn't have enough approvals yet. 0 of 1 approvals granted.
This branch is out-of-date with the base branch
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u github-actions-permissions:AdamWill-github-actions-permissions
git switch AdamWill-github-actions-permissions
Sign in to join this conversation.
No reviewers
Labels
Clear labels
404

Broken links or missing content
backport/v1.19

Changes which should be backported to the v1.19 docs

Archived

backport/v1.20

Changes which should be backported to the v1.20 docs

Archived

backport/v1.21

Changes which should be backported to the v1.21 docs

Archived

backport/v10.0

Automated backport to v10.0

Archived

backport/v11.0

Automated backport to v11.0
backport/v12.0

Automated backport to v12.0

Archived

backport/v13.0

Automated backport to v13.0
backport/v14.0

Automated backport to v14.0
backport/v7.0

Automated backport to the v7.0 docs

Archived

backport/v8.0

Automated backport to the v8.0 docs

Archived

backport/v9.0

Automated backport to the v9.0 docs

Archived

good first issue

This issue is suitable for "drive-by contributors" wanting to contribute for the first time, and fixing it should be straightforward.
meta

Tooling and processes for maintaining the docs
new docs

Content to be added to the documentation

Archived

User research - Accessibility

Requires input about accessibility features, likely involves user testing.
User research - Blocked

Do not pick as-is! We are happy if you can help, but please coordinate with ongoing redesign in this area.
User research - Community

Community features, such as discovering other people's work or otherwise feeling welcome on a Forgejo instance.
User research - Config (instance)

Instance-wide configuration, authentication and other admin-only needs.
User research - Errors

How to deal with errors in the application and write helpful error messages.
User research - Filters

How filter and search is being worked with.
User research - Future backlog

The issue might be inspiring for future design work.
User research - Git workflow

AGit, fork-based and new Git workflow, PR creation etc
User research - Labels

Active research about Labels
User research - Moderation

Moderation Featuers for Admins are undergoing active User Research
User research - Needs input

Use this label to let the User Research team know their input is requested.
User research - Notifications/Dashboard

Research on how users should know what to do next.
User research - Rendering

Text rendering, markup languages etc
User research - Repo creation

Active research about the New Repo dialog.
User research - Repo units

The repo sections, disabling them and the "Add more" button.
User research - Security
User research - Settings (in-app)

How to structure in-app settings in the future?
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
3 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
forgejo/docs!1673
Reference in a new issue
forgejo/docs
No description provided.
Delete branch "AdamWill/docs:github-actions-permissions"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?