TeamCity On-Premises 2020.2 Help

Managing your User Account

To get to your user profile settings, click your name in the header and select Profile from the drop-down menu. The My Settings & Tools page will open.

Changing Your Password

If built-in authentication is configured, TeamCity server maintains passwords for the user authentication. You can change your password in My Settings & Tools | General | Built-in Authentication. Enter an existing and new passwords and click Save changes.

The password can only be changed for the built-in authentication. If you don't see these fields, this means that TeamCity is configured to use external authentication and the password should be changed in the corresponding external system.

You can reset your built-in authentication password using the Reset password link on the sign-in page.

If you change or reset your password, TeamCity will automatically sign you out of all sessions.

Managing Access Tokens

If token-based authentication is enabled on the TeamCity server, you can create access tokens and use them for authentication:

  • instead of your password (for example, in scripts or IDE plugin login), or

  • as the value of the Authorization: Bearer <token-value> HTTP header. For instance, in REST API requests:

    curl --header "Authorization: Bearer <token-value>" http://<host>:<port>/app/rest/builds

Since TeamCity 2020.2, you can also add time-limited tokens which will be revoked after their expiration.

You can manage tokens in My Settings & Tools | Access Tokens. Note that the token value is only available during token creation and is not possible for retrieval afterwards.

Managing Version Control Username Settings

In My Settings & Tools | General, you can see the list of your version control usernames in the Version Control Username Settings area.
By default, TeamCity uses your login name as the VCS username. Click Edit to provide actual usernames for version control systems you use. Make sure the usernames are correct.
These settings are not used for authentication for the particular VCS, and so on.

These settings enable you to:

Customizing UI

In My Settings & Tools | General, you can customize the following UI settings:

  • Highlight my changes and investigations: Select to highlight builds that include your changes (changes committed by a user with the VCS username provided in the Version Control Username Settings section) and problems you were assigned to investigate on the Projects page, Project Home page, Build Configuration Home page.

  • Show date/time in my timezone: Check the option, if you want TeamCity to automatically detect your time zone and show the date and time (for example, build start, VCS change time, and so on) according to it.

  • Show all personal builds

  • Add builds manually triggered by you to your favorites.

Viewing your Roles and Permissions

In My Settings & Tools | Groups, you can view the list of user groups you are assigned to.

In My Settings & Tools | Roles, you can view your roles and permissions in different projects. Note, that roles are assigned to a user by the system administrator.

Last modified: 17 March 2021