Skip to content

docs: document Windows setup fix for prisma .env symlink error#28101

Merged
sahitya-chandra merged 5 commits intocalcom:mainfrom
khushal-winner:docs/windows-env-fix
Mar 1, 2026
Merged

docs: document Windows setup fix for prisma .env symlink error#28101
sahitya-chandra merged 5 commits intocalcom:mainfrom
khushal-winner:docs/windows-env-fix

Conversation

@khushal-winner
Copy link
Contributor

@khushal-winner khushal-winner commented Feb 20, 2026

What does this PR do?

This PR documents a Windows-specific issue affecting packages/prisma/.env during local development setup.

On Windows, the file may be created as a Unix-style symlink pointing to ../../.env. This can cause the following error:

unexpected character "/" in variable name "../../.env"

The README now includes:

  • Explanation of why the issue happens on Windows
  • Command-line fix (Git Bash / WSL)
  • Manual fix (File Explorer method)

This PR only updates documentation and does not modify any application code.

Tested on

  • Windows 11
  • Git Bash
  • Docker Desktop

Visual Demo (For contributors especially)

A visual demonstration is strongly recommended, for both the original and new change (video / image - any one).

Video Demo (if applicable):

  • Show screen recordings of the issue or feature.
  • Demonstrate how to reproduce the issue, the behavior before and after the change.

Image Demo (if applicable):

  • failed setup proof before fix
image
  • after fix
image

Mandatory Tasks (DO NOT REMOVE)

  • [✔] I have self-reviewed the code.
  • [✔] I have updated the developer docs in /docs if this PR makes changes that would require a documentation change. N/A – this PR only updates README.md.
  • [✔] I confirm automated tests are in place that prove my fix is effective or that my feature works. N/A – documentation-only change.

How should this be tested?

  1. Follow the local setup instructions on Windows.

  2. Allow packages/prisma/.env to be created as a symlink.

  3. Run yarn dx

  4. Observe the error:

    unexpected character "/" in variable name "../../.env"

  5. Apply the documented fix (remove the symlink and copy the root .env file).

  6. Re-run yarn dx.

Expected result:

  • The error no longer occurs.
  • Prisma setup and Docker database initialization succeed.

Open with Devin

@CLAassistant
Copy link

CLAassistant commented Feb 20, 2026

CLA assistant check
All committers have signed the CLA.

@graphite-app graphite-app bot added the community Created by Linear-GitHub Sync label Feb 20, 2026
Copy link
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 2 files

Removed 'link-as-an-app' from the list of apps.
Copy link
Member

@sahitya-chandra sahitya-chandra left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have also seen contributors using Windows facing this issue while locally setting up.

removed option 2
@pull-request-size pull-request-size bot added size/XS and removed size/S labels Mar 1, 2026
Copy link
Contributor

@devin-ai-integration devin-ai-integration bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 1 additional finding.

Open in Devin Review

@sahitya-chandra sahitya-chandra added the run-ci Approve CI to run for external contributors label Mar 1, 2026
@sahitya-chandra sahitya-chandra enabled auto-merge (squash) March 1, 2026 12:41
@sahitya-chandra sahitya-chandra merged commit 1c193cc into calcom:main Mar 1, 2026
58 of 63 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

community Created by Linear-GitHub Sync ready-for-e2e run-ci Approve CI to run for external contributors size/XS

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants