Organizations and Teams

What are Organizations?

Organizations in MokoGitea let you group repositories and manage access for departments, projects, or clients. They're ideal for businesses that need to separate concerns across multiple teams while maintaining centralized control.

Creating an Organization

1. Click the + icon in the top navigation and select New Organization.
2. Enter an Organization Name (this becomes part of the URL).
3. Set the Visibility — public or restricted.
4. Click Create Organization.

Managing Members

Add members to your organization from the Members tab:

1. Click Invite Member.
2. Search for the user by their MokoGitea username.
3. Assign them to one or more Teams.

Teams and Permissions

Teams allow fine-grained access control within an organization:

• Owners — Full administrative access to all organization resources.
• Custom Teams — Create teams with specific permissions:
  • Read — View repositories and issues.
  • Write — Push code and manage issues.
  • Admin — Full control over assigned repositories.

Creating a Team

1. Go to the organization's Settings → Teams.
2. Click Create New Team.
3. Name the team and set its permission level.
4. Choose which repositories the team can access — All Repositories or Specific Repositories.
5. Click Create Team, then add members.

Organization Repositories

Repositories created under an organization are owned by the organization, not an individual. This means:

• Access is managed through teams, not personal permissions.
• Repositories persist even if a member leaves.
• All team members with the appropriate permissions can collaborate.

Best Practices

• Use organizations to separate client projects, internal tools, and shared libraries.
• Create a Developers team with write access and an Ops team with admin access.
• Use the Owners team sparingly — only for administrators who need full control.