TeamCity
 
3.0
You are viewing the documentation for an earlier version of TeamCity.
  1. TeamCity Documentation
  2. Concepts
  3. Permission

Permission

Last modified: 20 April 2023

A permission is an authorization granted to TeamCity users to perform particular operations. In TeamCity the administrator assigns roles to users. Each Role has a set of permissions. A user can have different roles in different projects, and hence, the permissions are project-based.

Permissions in TeamCity Enterprise



In TeamCity Enterprise offers flexible uses of roles, which can be assigned users on a per-project basis.

tip

Permissions can manually be added or removed from roles listed below by editing the roles-config.xml file in the config directory of the TeamCity Data Directory. When assigning roles, the view role permissions link in the Web UI will accurately display a list permissions for each role in accordance to how they have been manually re-configured.

Enterprise Roles

Permissions

Project Viewer

View project

Project Developer

Run/stop build, remove build from the queue, pin/unpin build, tag build, pause/activate build configuration, clean build configuration sources, take responsibility, view project, view build configuration settings, view VCS file content, manually label build, and reorder builds in the queue

Agent Manager

Change agent run configuration policy, and enable/disable agent

Project Administrator

All of the project developer and agent manager permissions and edit project, change clean up rules, change user roles in a project, stop any personal build and remove it from the queue

System Administrator

All of the project administrator permissions and create/copy project, change shared VCS root, create/delete user account, modify user profile and roles, manage server licenses, change server settings, clean sources on an agent, authorize agent, configure server data cleanup, change own profile

Permissions in TeamCity Professional



tip

In TeamCity Professional roles are fixed across all of the projects and permissions cannot be added or removed from a role.

Professional Roles

Permissions

Guest

View projects

User

Run/stop build and remove build from the queue, pin/unpin build, tag build, pause/activate build configuration, clean build configuration sources, take responsibility, view project, view build configuration settings, view VCS file content, manually label build, reorder builds in the queue

Administrator

All of the user permissions and change agent run configuration policy, enable/disable agent, edit project, change clean up rules, change user roles in a project, stop any personal build and remove it from the queue, create/copy project, change shared VCS root, create/delete user account, modify user profile and roles, manage server licenses, change server settings, clean sources on an agent, authorize agent, configure server data cleanup, change own profile