Repository Permissions

When you invite collaborators to join your repository (see Invite Collaborators) or when you create teams for your organization (see Create and Manage an Organization), you have to decide what each collaborator/team is allowed to do.

Since Gitea v1.16, you can assign teams different levels of permission for each unit (e.g. issues, PR's, wiki).

Collaborators

There are four permission levels: Read, Write, Administrator and Owner.
The owner is the one who created the repository.

The table below gives an overview of what collaborators are allowed to do when granted each of these permission levels:

Task Read Write Admin Owner
View, clone and pull repository
Contribute pull requests
Push to/update contributed pull requests
Push directly to repository
Merge pull requests
Moderate/delete issues and comments
Force-push/rewrite history (if enabled)
Add/remove collaborators to repository
Configure branch settings (protect/unprotect, enable force-push)
Configure repository settings (enable wiki, issues, PRs, update profile)
Configure repository settings in the danger zone (transfer ownership, delete wiki data / repository, archive repository)

Teams

The permissions for teams are quite configurable. You can specify which organization repository the team has access to. Therefore, you can specify for each unit (a unit refers to a specific subset of a repository, e.g. Code Access, Issues, Releases) a different permission level.

Each unit is configured to have one of the 3 permission levels:

  • No Access: Members cannot view or take any other action on this unit.
  • Read: Members can view the unit and do standard actions for that unit (See the Read column under Collaborators).
  • Write: Members can view the unit and execute a writing action for that unit (See the Write column under Collaborators).

When a team is configured to have administrator access, when this is specified, you cannot change units. The team will have admin permissions (See the Admin column under Collaborators).

Currently, there are six units that can be configured:

  • Code, access source code, files, commits, and branches.
  • Issues, organize bug reports, tasks, and milestones.
  • Pull Requests, access to pull requests, and code reviews.
  • Releases, track the project versions and downloads.
  • Wiki, access and write documentation.
  • Projects, access and manage issues and pull requests in project boards.

There are also two units which can be toggled:

  • External Wiki, access to external wiki.
  • External Issues, access to the external issue tracker.

A team can be given the permission to create new repositories. When a member of such team creates a new repository, it will get administrator access to the repository.


Hey there! 👋 Thank you for reading this article!

Is there something missing or do you have an idea on how to improve the documentation? Do you want to write your own article?

You're invited to contribute to the Codeberg Documentation at its source code repository, for example by Adding a pull request or joining in on the discussion in the issue tracker.

For an introduction on contributing to Codeberg Documentation, please have a look at the Contributor FAQ.

© Codeberg Docs Contributors. See LICENSE