Bamboo fails to checkout in a Windows environment due to colons on filenames
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs 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:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
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 moreCause
Filenames cannot have colons in Windows operating systems.
Resolution
Rename the filenames so that they don't have colons and commit again.
Updated on April 10, 2025
Was this helpful?
Still need help?
The Atlassian Community is here for you.