This page contains a list of workarounds for known issues in TeamCity.
To see issues specific to particular versions of TeamCity, go to the respective section of upgrade notes.
Incompatibility with JDK 8 update 242+
TeamCity versions up to 2019.2.1 running under JDK 8u242+ can report
java.lang.NoClassDefFoundError: Could not initialize class XXX errors, for example, on Git operations or Windows domain authentication operations.
Until TeamCity 2019.2.2 is released, it is recommended to use Java 8u232 version for TeamCity server.
Agent running as Windows Service Limitations
When a TeamCity build agent is installed as a Windows service, there may appear various "Permission denied" or "Access denied" errors during the build process, see details below.
Windows service limitations
As a Windows service, the TeamCity agent and the build processes are not able to access network shares and mapped drives.
To overcome these restrictions, run TeamCity agent via console.
Issues with automated GUI and browser testing
These problems include errors running tests headless, issues with the interaction of the TeamCity agent with the Windows desktop, and so on.
To resolve / avoid these:
Run TeamCity agent via console.
Configure the build agent machine not to launch a screensaver locking the desktop.
Configure the TeamCity agent to start automatically (for example, configure an automatic user logon on Windows start and then configure the TeamCity agent start (via
agent.bat start) on the user logon).
For graphical tests the build agent cannot be started as a service and it is recommended to configure the build agent launch with a 1 minute delay after the user auto-logon, e.g. using the
bin\agent.bat start command in the task scheduler and configuring the delay there.
Running automated GUI tests and using RDP
RDP uses its own video driver overriding the one from the machine's video card for the session. Redirecting the session to console will unload the Windows graphical drivers. This can be done by adding the following step to your build configuration prior to your tests (the example below is for PowerShell, but other languages (DOS, Python) can be used too):
quser [current username] lists all the connections to that machine for the user, either console or graphical.
The one listed as
rdp-tcp#* is the remote desktop connection which can be redirected to the console using
tscon [connection id] /dest:console.
Issues with .NET Selenium
When a TeamCity agent is started as a Windows service and automated tests for .NET applications use Selenium WebDriver, the tests may fail due to browser drivers limitations. As a solution, consider starting the agent manually.
Early start of the service before other resources are initialized
To handle this, consider using the Automatic (Delayed Start) option of the service settings or configure service dependencies.
For more investigation steps, see the Common Problems page.
java.lang.OutOfMemoryError: unable to create new native thread error
If your TeamCity server is running on SUSE® Linux Enterprise (or using systemd Daemon), the java.lang.OutOfMemoryError: unable to create new native thread error may be caused by the cgroup process number controller feature limiting the number of processes and the amount of threads in a cgroup to 512 by default.
Increasing the limit (for example, to 4096) on the TeamCity server should solve the issue.
See also this external posting.
Clearing Browser Caches
There is a web UI-related issue which some users have encountered (and it cannot be reproduced on other computers) which is tied to the cached versions of content. If you have come across such problem, make sure your browser does not use cached versions of content by clearing browser caches.
Logging with Log4j in Your Tests
If you use Log4j logging in your tests, in some cases you may miss the Log4j output from your logs. In such cases do the following:
Use Log4j 1.2.12
For Log4j 1.2.13+, add the
Follow=trueparameter for the console appender used in Log4j configuration:<appender name="CONSOLE" class="org.apache.log4j.ConsoleAppender"> <param name="Follow" value="true"/> </appender>
Agent Service Can Exit on User Logout under Windows x64
The used version of Java Service Wrapper does not fully support Windows 64 and this causes agent launcher process to be killed on user logout. The agent itself will be function until the next restart (server upgrade or agent properties change).
Failed Build Can be Reported as a Successful One With Maven 2.0.7
This is a known bug in this version of Maven. Consider using any later version.
In case it's not possible, you can patch
mvn.bat yourself by replacing the fragment at line 148 of
with the following one:
Most common indicators of conflicting software are errors like "Access is denied", "Permission denied" or java.io.FileNotFoundException mentioning the file that is present and is writable by the user the agent/build runs under. Also, certain software running in the background (like antivirus) can significantly slow down such build agent operations as sources checkout, artifact publishing or even build running.
Certain antivirus software like Kaspersky Internet Security can result in Java process crashes or other misbehavior like inability to access files. For example, see this issue.
ESET antivirus can also slow down Ant/IntelliJ IDEA project builds a great deal (slowing down TCP connections to localhost on an agent).
If you run antivirus on the TeamCity server or agent machines and get disk access errors or experience degraded performance, you may consider temporarily disabling the antivirus software before investigating the issue and reporting it to JetBrains. Note that disabling the antivirus can make your setup more vulnerable to potential external attacks — ensure you take proper security measures before doing this.
It is recommended to exclude entire TeamCity server home and TeamCity Data Directory from the background checks and perform periodical checks there in the well-known maintenance window so that those do not affect server performance much. On TeamCity agent, it is recommended to exclude TeamCity agent home from the background checks.
There might be problems with the Windows Indexing Service, so disable various indexing services. See the related issue for more details. Windows System Restore Feature might also need disabling.
Do not install software with background indexing like WinCVS, TortoiseCVS, TortoiseSVN, and other Tortoise* products. This applies to server and also to agents if you use agent-side checkout.
Skype software is known to corrupt layout of pages displayed in Internet Explorer. (TW-13052).
svn: E175002: Received fatal alert: bad_record_mac
Add a system property
-Dsvnkit.http.sslProtocols=SSLv3,TLS on the build server (see Configuring TeamCity Server Startup Properties).
If you use checkout on agent, add this property on build agent as well.
Subversion-related JVM Crashes
If JVM crashes while executing SVN-related code (e.g. under org.tmatesoft.svn package), you can try to disable it using one of the options:
-Dsvnkit.useJNA=falseJVM option to the crashing process (server or agent)
Making NTLM support less prioritative by passing the
Anyway, upgrading the JVM used to the latest available version is recommended.
NUnit 2.4.6 Performance
Due to an issue in NUnit 2.4.6, its performance may be slower than NUnit 2.4.1. For additional information, refer to the corresponding issue in our issue tracker: TW-4709
Using StarTeam SDK 9.0 instead of StarTeam SDK 9.3 on the TeamCity server can significantly improve VCS performance when there is a slow connection between TeamCity and StarTeam servers.
Perforce 2009.2 Performance on Windows
If you run Perforce 2009.2 on Windows you may experience significant slow down. This is an issue with P4 server running on Windows. Refer to corresponding section in Perforce documentation.
Wrong times for build scheduled triggering (Timezone issues)
Make sure you use the latest update for Java 8 installation available for your platform (e.g. OpenJDK 8 by Amazon Corretto).
Upgrading IntelliJ IDEA May Affect Active Pre-Tested Commits
Before you upgrade to IntelliJ IDEA X (or other IntelliJ X platform products), make sure you do not have active pre-tested commits, otherwise they will not be able to be committed after upgrade. This is only relevant if you use directory-based IDEA project (project files are stored under
Other Java Applications Running on the Same Server
If other web applications are available via the same hostname, a session cookie conflict can occur. This usually is visible via random user logouts or losing session-level data. (e.g. TW-12654). To resolve this, you can use different host names when accessing the applications.
The Server Does Not Start Claiming the Database is in Use
Only a single TeamCity server can work with one database, which is checked on the TeamCity server start.
The Database is in Use" error on the start-up is reported in either of the following cases:
An attempt to start more than one TeamCity server connected to the same database
A second TeamCity instance detected
The internal HSQL database is being used by another application
The error is most probably caused by the fact that there is another running TeamCity installation which is connected to the same database. Сheck that the database properties are correct and there is no other TeamCity server using the same database.
Slow download from TeamCity server
If you experience slow speed when downloading artifacts from TeamCity, try checking the speed on the server machine, downloading from localhost. If the speed is OK for the localhost, the issue can be in the network configuration or OS/hardware settings when combined with TeamCity (Tomcat) settings.
Make sure <TeamCity Home>\conf\server.xml file corresponds to the file included in TeamCity distribution (can be checked in .tar.gz distribution). If you have the following "Connector" node (ports numbers can be different):
change it to:
and restart TeamCity server.
If this does not help with the download speed, to investigate the case, you might need to find an administrator with appropriate network-related issues investigation skills to look into the case.
Failure to publish artifacts to server behind IIS reverse proxy
This problem is only relevant to configurations that involve an IIS reverse proxy between the build server and agents. Sometimes a build agent can be found in infinite loop trying to publish build artifacts to the server. The build log looks like this:
teamcity-agent.log is filled with 404 responses from IIS:
The most common cause for this is
maxAllowedContentLength setting (in IIS) is either
set to too small value, or
left unconfigured and so defaults to 30000000 bytes (<30 Mb)
So any artifact larger than
maxAllowedContentLength is discarded by IISCheck the settings value and try to rerun your build
Artifacts Domain Isolation in setups with IIS causes authorization error on accessing artifacts
If Artifacts Domain Isolation is enabled on your TeamCity server, trying to access build artifacts might result in the 401 Unauthorized error. This issue is most likely caused by the default behavior of your IIS web server: it rewrites the response headers targeting them back from the artifacts' domain to the main server domain. To disable this behavior, go to Application Request Routing | Server Proxy Settings in the IIS interface and disable the "Reverse rewrite host in response headers" option.
Content Missing from TeamCity UI
When loading a TeamCity page, you might notice some content missing. Most commonly, build configurations that have finished builds do not display their build histories and appear empty. At the same time, a web browser logs multiple 404 (Not Found) errors.
If this happens for a TeamCity instance running on an IIS server, check the values of the IIS
maxQueryString values. These settings limit the maximum length of query strings. If these limits are too low, some of REST requests TeamCity sends to the
<server-url>/app/rest/... endpoints may fail.
To resolve this issue, increase these limits in the
web.config file of your IIS server. The exact value should depend on your current configuration and the length of your project/configuration IDs. As a general recommendation, set this limit to 4000 characters and gradually raise it if the issue persists.
SSL problems when connecting to HTTPS from TeamCity (handshake alert: unrecognized_name)
This problem may happen when changing JVM from 1.6 to 1.7 and connecting some incorrectly configured HTTPS servers. The problem and workaround for it are described in this issue.
Distorted Configuration Window During Agent Reinstallation
When installing a TeamCity agent via a Windows agent installer on top of the already installed agent with a different version of Java, the "Configure Build Agent Properties" installation window might appear distorted.
This issue has been fixed in TeamCity 2019.1.5.
To work around this issue without upgrading to 2019.1.5, uninstall the previously installed agent version before installing a new agent into the same directory.
To uninstall the agent, invoke
Uninstall.exe in the Agent Home Directory, clear all the "Remove..." checkboxes to keep the agent logs and configuration, and click Uninstall. After the successful uninstallation, you can proceed with installing the new agent version via the agent installer.
Windows Docker Containers
Problems common to TeamCity Docker container images.
Since Windows 10 version 1803 with KB4340917 it's possible to use port mapping from containers to localhost. For previous Windows versions it works for the non-localhost IP address associated with this machine and you can access a running application via the machine's hostname or determine the IP address via the
ipconfigcommand. Note that the
netstat -ancommand may not show that the port is open on any IP address, while in fact it can work. This is also a known problem of Docker on Windows.
On Windows 10, the memory allocated per container is 1GB by default. To increase this value, use the following memory options:docker run ... -m 6GB --cpus=4 -e TEAMCITY_SERVER_MEM_OPTS="-Xmx3g -XX:ReservedCodeCacheSize=640m"
On Windows 10 containers work via Hyper-V and may experience problems with network and other subsystems. To diagnose these problems, execute the following PowerShell script:Invoke-WebRequest https://aka.ms/Debug-ContainerHost.ps1 -UseBasicParsing | Invoke-Expression
When starting a TeamCity server from a Windows Docker image, make sure to grant "Authenticated Users" the Full Control over the directories used as volumes. See the related issue.
When starting a Windows Docker container with the directory
C:/BuildAgent/workmapped as a volume to the container host, Git for Windows fails with a following error: "Invalid path '/ContainerMappedDirectories': No such file or directory". The workaround is not to add
C:/BuildAgent/workas a volume.
Information about installed Docker server OS on Windows missing on Agent
On Windows 10, the Docker server depends on Hyper-V service and its start may take a significant amount of time. To resolve the issue, configure the TCBuildAgent Windows service to depend on the Docker for Windows Service,
com.docker.service by default.
Linux Docker Containers under Windows
The Container Wrapper works on Windows when Windows-based containers are started.
If a Linux container is started on a Windows machine, TeamCity displays the error message "Starting Linux Docker containers under Windows is not supported. To avoid this problem, add the
teamcity.agent.jvm.os.name does not contain Windows agent requirement.
Problems with a local time in Windows containers
When using Windows Docker containers, there is an issue with incorrect time in Windows containers when the system time in a container goes out of sync with the time on the host machine. It could cause problems in integrations where response time is significant (for example, OAuth tokens).
To address it, upgrade your host machine to Windows Server 2019 / Windows 10 1809 and use TeamCity docker images compatible with Windows containers 1809.
"Access is denied" or "Access to the path is denied" problem on container start
When Docker is starting Windows containers with process isolation, it uses a Windows user account which lacks the write access to the directory with Docker volumes. In this case, build agents may fail to start due to the "Access to the path is denied" or "Access is denied" error.
To resolve this issue, specify a dedicated volume mapping for the
..\TeamCity\temp directory in the
docker run command. We also suggest ensuring that a sufficient amount of resources is allocated to this process.
Alternatively, you can grant the "Full control" permission to the "Authenticated Users" group for the
dotCover known issues
dotCover does not support Windows Nano Server
If you try to run dotCover on an agent with the Nano Server OS, the build will fail with an exit error "Process exited with code -1073741515". Instead of Nano Server, consider using Server Core which is an alternative minimal installation option of Windows Server.
dotCover does not support coverage statistics for msbuild
dotCover does not support collection of coverage statistics for the
dotnet msbuild /t:vstest command — use
dotnet test instead.
Code coverage configuration using Test Settings is deprecated
Code coverage configuration using Test Settings is deprecated in dotCover. Read more in Microsoft documentation.
If you use
.testsettings files, TeamCity will display a warning message in the log. To prevent this issue, we suggest that you use
.runsettings files instead. If, for some reason, you have to continue using
.testsettings, install dotCover version 2019.1.x or earlier on TeamCity agents, as described here.
Xcode 10 is unable to clean artifacts in custom output directory
If you use a custom output directory for Xcode, note that on upgrading to Xcode 10, TeamCity builds with the Xcode Project build runner might fail with the error: "Could not delete <directory> because it was not created by the build system and it is not a subfolder of derived data."
This is caused by the following Xcode 10 known issue:
xcodebuild clean on a project that uses a customized build location outside the derived data directory, and that has older build products produced prior to Xcode 10, Xcode might report an error indicating that it won't delete directories not created by the new build system. (40427159)
See Xcode documentation for details.
To resolve this issue, we suggest that you use Xcode 11 instead. To work around this issue in Xcode 10, you can either clean the output directory manually or try using the previous build system by passing
-UseNewBuildSystem=NO to command line parameters.
Cross-server Projects pop-up menu may not work in latest browsers
If you cannot access the cross-server Projects menu, you can try to temporarily work around this issue by changing your browser settings:
In Google Chrome, open the
chrome://flagspage and disable the "SameSite by default cookies" option.
In Mozilla Firefox, open the
about:configpage and disable the
In Safari, go to Preferences | Privacy and disable the "Prevent cross-site tracking" option.
This problem will be resolved in the TeamCity 2020.1.5 update. See the related issue for more details.
.NET runner known issues
.NET runner is not compatible with obsolete external .NET CLI Support plugin
The reworked .NET build runner is not compatible with the obsolete external plugin .NET CLI Support (used in versions 2017.1 and earlier). If the obsolete plugin is installed on your server, you will get the Error creating bean with name "jetbrains.buildServer.dotnet.DotnetRunnerRunType" after updating to TeamCity 2020.1. To solve this issue, please uninstall the obsolete plugin from your server.
Note that all the existing .NET CLI Support build steps are automatically switched to the new .NET runner on updating to TeamCity 2019.2.3 or later. For more information, refer to our upgrade notes.
Cannot create an instance of the logger when using early Visual Studio 2017 build
In rare cases, if an early build of Visual Studio 2017 is installed on your build agent, you might get the "Cannot create an instance of the logger" error when running the .NET build step. This might be caused by the logger's incompatibility with the framework version being used.
To work around this problem, you can upgrade Visual Studio 2017 to the latest build or, alternatively, install any later version of .NET Framework.
Parsing .rsp files (Error MSB1006: Property is not valid)
Due to the breaking change introduced by Microsoft in the core
System.CommandLine library, .rsp files with commas and (or) semicolons in property values are parsed incorrectly. To ensure this issue does not occur, enclose values of system properties in quotes. If this solution is not applicable to your project, add the
teamcity.internal.dotnet.msbuild.parameters.escape configuration parameter and set its value to "true". With this setting enabled, TeamCity automatically wraps values of user-defined properties in quotes.
NuGet known issues
Prerelease packages are not visible in the TeamCity NuGet feed
Problem: Prerelease packages are not visible in the TeamCity NuGet feed.
Cause: NuGet clients prior to version 3 fail to list prerelease packages if the package version violates the required format.
Solution: Delete build artifacts whose versions violate the required format.
Packages indexing is slow in TeamCity NuGet feed
Problem: After TeamCity server host machine move or upgrade, build metadata can be reset.
Cause: The TeamCity NuGet feed relies on build metadata, and packages reindexing can take a lot of time depending on the number of packages and the idle time of the TeamCity server.
Solution: To speed up build metadata reindexing, specify the following internal properties:
To check the metadata indexing progress, look for lines similar to the ones below in the teamcity-server.log file:
After reindexing is complete, remove these internal properties.
NuGet does not pull recent package version
Problem: NuGet can sometimes skip the recent versions of packages when pulling these packages from the feed.
Cause: NuGet caches the server responses, thus pulling does not detect the most recent changes in the feed.
Solution: To send a new request directly to the server instead of the cache, use the
--no-cache parameter in your request.
Packages are not found in NuGet feed
Problem: Not all packages are found in a NuGet feed, though artifacts are present on the disk and in the UI and teamcity-nuget.log does not indicate that indexing of packages is in progress.
Cause: One of the possible causes could be that TeamCity was restored from backup or moved to a new server.
Solution: Clear the buildsMetadata cache and wait until reindexing of packages is finished on the server. Note that it could take a lot of time for a large server with a long build history.
Cannot use multiline parameters in PowerShell
Earlier versions of the PowerShell runner don't support passing multiline arguments. Since version 2020.1.4, you can enable this support by setting the
teamcity.powershell.arguments.multiline=true configuration parameter.
Error while loading VCS changes
Error while loading VCS changes on the TeamCity server startup might be associated with the enabled cursor-based streaming in MySQL. To prevent this error, try setting the
connectionProperties.useCursorFetch property to
database.properties and restart the server.
See this issue for more details.
Known issues of Pull Requests build feature
In some cases, TeamCity could start builds on old open merge requests in JetBrains Space and pull requests in Bitbucket Cloud. This is reproduced with the following sequence of steps:
Create a new VCS root that connects to a repository with open merge requests. Leave the default branch specification.
Create a build configuration with this VCS root and a VCS trigger.
Remove the branch specification from the VCS root.
Add the Pull Requests build feature to the build configuration.
Disable the Pull Requests feature and then enable it again.
See the related issue for more details.
Issues related to Git Repository Ownership Checks
Due to more strict repository ownership checks introduced in Git 2.35.2, updating the TeamCity server's Git to this or a newer version may result in malfunctions (for instance, the "fatal: could not read from remote repository" message). Try the following workarounds as temporary solutions:
If your TeamCity server runs on Linux, ensure the volume with the <TeamCity data dir>/system/caches/git directory is mounted under the same user that TeamCity utilizes to access this directory.
If you experience related issues on a TeamCity Server installed or updated via a Windows Docker image, disable the native Git to force the TeamCity server to use JGit instead.
Known issues of native Git checkout
SSH DSA keys do not work with native Git
Switching the server to native Git results in builds failing to authorize in repositories via SSH DSA keys. See the related issue TW-74580.
To work around this issue, please set the
teamcity.git.sshCommandOptions internal property to
Native Git via OpenSSH may fail
Native Git via OpenSSH may fail on Windows if the server/agent installation path contains spaces. See the related issue.
nonProxyHosts option for ssh proxy is not available
TeamCity uses an ssh proxy when connecting via native Git. See the related issue
Custom ssl certificates are not supported for native Git
Custom ssl certificates support for native Git on the server is not available. See the related issue
This issue was fixed in TeamCity 2022.10.1.
Publishing artifacts to third party S3-compatibles storages may fail
TeamCity 2022.04 changes the ACL setting related to the Amazon S3 artifact storage, which may cause publishing artifacts to third party S3-compatibles storages, such as Backblaze, to fail.
To fix this problem after updating to TeamCity 2022.04, download the plugin version from the related issue and add the
storage.s3.acl configuration parameter with the required
acl value. All the values listed here are supported.
Artifact Decompression Issues
The regular ZIP format supports archives up to 2^32 bytes (4 GB) in size. Since builds can produce artifacts that exceed this value, TeamCity compresses artifacts with the ZIP64 format that supports archives as large as 2^64 bytes (16 exabytes).
If tools that you utilize to unzip TeamCity build artifacts do not support ZIP64 (for example, you may observe header error warnings), add the following configuration parameters to a project (either a <Root project> or a specific project that produces unsupported archives):