Skip to content

Windows checkout fails due to invalid filename containing '*' in blog asset #8130

Description

Summary

Cloning the repository on Windows completes successfully, but the checkout fails because one of the blog asset filenames contains the * character, which is not supported on Windows (NTFS).

Environment

  • OS: Windows 11
  • Git: Git for Windows (OpenSSH)
  • Filesystem: NTFS

Steps to Reproduce

  1. Clone the repository:
git clone https://github.com/prisma/web.git
  1. Wait for the checkout to complete.

Actual Behavior

Git downloads the repository successfully, but fails during checkout with the following error:

error: invalid path 'apps/blog/public/connections-edges-nodes-in-relay-758d358aa4c7/imgs/0*sPafc6eXHJvRSJhZ.png'
fatal: unable to checkout working tree
warning: Clone succeeded, but checkout failed.

Expected Behavior

The repository should clone and check out successfully on Windows without requiring any additional configuration.

Root Cause

The filename:

apps/blog/public/connections-edges-nodes-in-relay-758d358aa4c7/imgs/0*sPafc6eXHJvRSJhZ.png

contains the * character.

While this is a valid filename on Unix-like systems, Windows (NTFS) does not allow the following characters in filenames:

< > : " / \ | ? *

As a result, Git cannot create the file during checkout and aborts the working tree checkout.

Additional Notes

  • The repository downloads successfully; only the checkout fails.
  • I was able to continue working using GitHub Codespaces, where the repository checks out without issues.
  • Renaming this asset to a Windows-compatible filename should resolve the problem for Windows contributors.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions