Bamboo fails to checkout in a Windows environment due to colons on filenames

Platform Notice: Data Center - This article applies to Atlassian products on the Data Center platform.

Note that this knowledge base article was created for the Data Center version of the product. Data Center knowledge base articles for non-Data Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Symptoms

Bamboo fails to checkout from the repository and the following appears in the atlassian-bamboo.log:

2013-08-23 15:51:24,861 ERROR [9-BAM::Agent Two::Agent:pool-22-thread-1] [TaskExecutorImpl] Error occurred while running Task 'Checkout Default Repository(1)' of type com.atlassian.bamboo.plugins.vcs:task.vcs.checkout.
java.lang.RuntimeException: com.atlassian.bamboo.repository.RepositoryException: ABCD-EFG-JOB1-2: Checkout to revision jlajlkda123jklj123bmnbjh12g12hfhgfh21f3hip12 has failed.The filename, directory name, or volume label syntax is incorrect
	at com.atlassian.bamboo.executor.RetryingTaskExecutor.rerun(RetryingTaskExecutor.java:132)
	at com.atlassian.bamboo.executor.RetryingTaskExecutor.runTask(RetryingTaskExecutor.java:88)
	at com.atlassian.bamboo.executor.RetryingTaskExecutor.retry(RetryingTaskExecutor.java:191)
	at com.atlassian.bamboo.executor.RetryingTaskExecutor.retry(RetryingTaskExecutor.java:176)
	at com.atlassian.bamboo.plugins.vcs.task.VcsCheckoutTask.execute(VcsCheckoutTask.java:169)
	at com.atlassian.bamboo.task.TaskExecutorImpl.executeTasks(TaskExecutorImpl.java:220)
	at com.atlassian.bamboo.task.TaskExecutorImpl.executePreparationTasks(TaskExecutorImpl.java:73)
	at com.atlassian.bamboo.build.pipeline.tasks.PrepareBuildTask.call(PrepareBuildTask.java:74)
	at com.atlassian.bamboo.v2.build.agent.DefaultBuildAgent.build(DefaultBuildAgent.java:188)
	at com.atlassian.bamboo.v2.build.agent.BuildAgentControllerImpl.waitAndPerformBuild(BuildAgentControllerImpl.java:102)
	at com.atlassian.bamboo.v2.build.agent.DefaultBuildAgent$1.run(DefaultBuildAgent.java:107)
	at com.atlassian.bamboo.build.pipeline.concurrent.NamedThreadFactory$2.run(NamedThreadFactory.java:52)
	at java.lang.Thread.run(Unknown Source)
Caused by: com.atlassian.bamboo.repository.RepositoryException: ABCD-EFG-JOB1-2: Checkout to revision jlajlkda123jklj123bmnbjh12g12hfhgfh21f3hip12 has failed.The filename, directory name, or volume label syntax is incorrect
	at com.atlassian.bamboo.plugins.git.JGitOperationHelper.doCheckout(JGitOperationHelper.java:182)
	at com.atlassian.bamboo.plugins.git.JGitOperationHelper.checkout(JGitOperationHelper.java:272)
	at com.atlassian.bamboo.plugins.git.GitRepository$3.call(GitRepository.java:342)
	at com.atlassian.bamboo.plugins.git.GitRepository$3.call(GitRepository.java:318)
	at com.atlassian.util.concurrent.ManagedLocks$ManagedLockImpl.withLock(ManagedLocks.java:312)
	at com.atlassian.bamboo.plugins.git.GitRepository.retrieveSourceCode(GitRepository.java:317)
	at com.atlassian.bamboo.plugins.git.GitRepository.retrieveSourceCode(GitRepository.java:293)
	at com.atlassian.bamboo.plugins.vcs.task.VcsCheckoutTask.fillWorkingDirFromVcs(VcsCheckoutTask.java:246)
	at com.atlassian.bamboo.plugins.vcs.task.VcsCheckoutTask.access$100(VcsCheckoutTask.java:54)
	at com.atlassian.bamboo.plugins.vcs.task.VcsCheckoutTask$2.call(VcsCheckoutTask.java:173)
	at com.atlassian.bamboo.plugins.vcs.task.VcsCheckoutTask$2.call(VcsCheckoutTask.java:170)
	at com.atlassian.bamboo.executor.RetryingTaskExecutor.rerun(RetryingTaskExecutor.java:108)
	... 12 more
Caused by: java.io.IOException: The filename, directory name, or volume label syntax is incorrect
	at java.io.WinNTFileSystem.createFileExclusively(Native Method)
	at java.io.File.createTempFile(Unknown Source)
	at org.shaded.eclipse.jgit.dircache.DirCacheCheckout.checkoutEntry(DirCacheCheckout.java:933)
	at org.shaded.eclipse.jgit.dircache.DirCacheCheckout.doCheckout(DirCacheCheckout.java:447)
	at org.shaded.eclipse.jgit.dircache.DirCacheCheckout.checkout(DirCacheCheckout.java:380)
	at com.atlassian.bamboo.plugins.git.JGitOperationHelper.doCheckout(JGitOperationHelper.java:132)
	... 23 more

Cause

Filenames cannot have colons in Windows operating systems.

Resolution

Rename the filenames so that they don't have colons and commit again.

Last modified on Jan 31, 2025

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.