{
  "doc": {
    "id": "app/references/advanced-installation",
    "title": "Advanced Installation Instructions for Cypress",
    "description": "Learn how to install Cypress with a custom binary, skip the installation of the Cypress binary, change the Cypress binary cache location or download URL and more",
    "section": "app",
    "source_path": "/llm/markdown/app/references/advanced-installation.md",
    "version": "3cf5b86b3403f604bdf7f3e35025c3bc3865e02c",
    "updated_at": "2026-05-07T17:44:31.931Z",
    "headings": [
      {
        "id": "app/references/advanced-installation#advanced-installation",
        "text": "Advanced Installation",
        "level": 1
      },
      {
        "id": "app/references/advanced-installation#what-youll-learn",
        "text": "What you'll learn",
        "level": 5
      },
      {
        "id": "app/references/advanced-installation#environment-variables",
        "text": "Environment variables",
        "level": 2
      },
      {
        "id": "app/references/advanced-installation#proxy-configuration",
        "text": "Proxy configuration",
        "level": 2
      },
      {
        "id": "app/references/advanced-installation#install-binary",
        "text": "Install binary",
        "level": 2
      },
      {
        "id": "app/references/advanced-installation#skipping-installation",
        "text": "Skipping installation",
        "level": 3
      },
      {
        "id": "app/references/advanced-installation#troubleshoot-installation",
        "text": "Troubleshoot installation",
        "level": 3
      },
      {
        "id": "app/references/advanced-installation#binary-cache",
        "text": "Binary cache",
        "level": 2
      },
      {
        "id": "app/references/advanced-installation#run-binary",
        "text": "Run binary",
        "level": 2
      },
      {
        "id": "app/references/advanced-installation#mac",
        "text": "Mac",
        "level": 3
      },
      {
        "id": "app/references/advanced-installation#linux",
        "text": "Linux",
        "level": 3
      },
      {
        "id": "app/references/advanced-installation#windows",
        "text": "Windows",
        "level": 3
      },
      {
        "id": "app/references/advanced-installation#download-urls",
        "text": "Download URLs",
        "level": 2
      },
      {
        "id": "app/references/advanced-installation#mirroring",
        "text": "Mirroring",
        "level": 2
      },
      {
        "id": "app/references/advanced-installation#download-path-template",
        "text": "Download path template",
        "level": 2
      },
      {
        "id": "app/references/advanced-installation#using-a-custom-certificate-authority-ca",
        "text": "Using a custom certificate authority (CA)",
        "level": 2
      },
      {
        "id": "app/references/advanced-installation#opt-out-of-sending-exception-data-to-cypress",
        "text": "Opt out of sending exception data to Cypress",
        "level": 2
      },
      {
        "id": "app/references/advanced-installation#opt-out-on-linux-or-macos",
        "text": "Opt out on Linux or macOS",
        "level": 3
      },
      {
        "id": "app/references/advanced-installation#opt-out-on-windows",
        "text": "Opt out on Windows",
        "level": 3
      },
      {
        "id": "app/references/advanced-installation#opt-out-of-cypress-commercial-messaging",
        "text": "Opt out of Cypress commercial messaging",
        "level": 2
      },
      {
        "id": "app/references/advanced-installation#install-pre-release-version",
        "text": "Install pre-release version",
        "level": 2
      },
      {
        "id": "app/references/advanced-installation#windows-subsystem-for-linux",
        "text": "Windows Subsystem for Linux",
        "level": 2
      },
      {
        "id": "app/references/advanced-installation#uninstall-cypress",
        "text": "Uninstall Cypress",
        "level": 2
      }
    ]
  },
  "chunks": [
    {
      "id": "app/references/advanced-installation#what-youll-learn",
      "doc_id": "app/references/advanced-installation",
      "heading": "What you'll learn",
      "heading_level": 5,
      "content_markdown": "##### What you'll learn\n\n*   How to install Cypress with a custom binary\n*   How to skip the installation of the Cypress binary\n*   How to change the Cypress binary cache location or download URL\n*   How to use a custom certificate authority (CA)\n*   How to opt out of sending exception data to Cypress\n",
      "section": "app",
      "anchors": [
        "what-youll-learn"
      ],
      "path": "/llm/json/chunked/app/references/advanced-installation.json",
      "token_estimate": 73
    },
    {
      "id": "app/references/advanced-installation#environment-variables",
      "doc_id": "app/references/advanced-installation",
      "heading": "Environment variables",
      "heading_level": 2,
      "content_markdown": "## Environment variables\n\n| Name | Description |\n| --- | --- |\n| `CYPRESS_INSTALL_BINARY` | [Destination of Cypress binary that's downloaded and installed](#Install-binary) |\n| `CYPRESS_CONNECT_RETRY_THRESHOLD` | Overrides the maximum number of retries when connecting to a browser. The default value is 62. |\n| `CYPRESS_DOWNLOAD_MIRROR` | [Downloads the Cypress binary through a mirror server](#Mirroring) |\n| `CYPRESS_DOWNLOAD_PATH_TEMPLATE` | [Allows generating a custom URL to download the Cypress binary from](#Download-path-template) |\n| `CYPRESS_CACHE_FOLDER` | [Changes the Cypress binary cache location](#Binary-cache) |\n| `CYPRESS_RUN_BINARY` | [Location of Cypress binary at run-time](#Run-binary) |\n| `CYPRESS_VERIFY_TIMEOUT` | Overrides the timeout duration for the `verify` command. The default value is 30000. |\n| `CYPRESS_SKIP_VERIFY` | Skips the [`verify` command](/llm/markdown/app/references/command-line.md#cypress-verify) when `true` |\n| CYPRESS\\_SKIP\\_BINARY\\_INSTALL | removed use `CYPRESS_INSTALL_BINARY=0` instead |\n| CYPRESS\\_BINARY\\_VERSION | removed use `CYPRESS_INSTALL_BINARY` instead |\n",
      "section": "app",
      "anchors": [
        "environment-variables"
      ],
      "path": "/llm/json/chunked/app/references/advanced-installation.json",
      "token_estimate": 180
    },
    {
      "id": "app/references/advanced-installation#proxy-configuration",
      "doc_id": "app/references/advanced-installation",
      "heading": "Proxy configuration",
      "heading_level": 2,
      "content_markdown": "## Proxy configuration\n\nSystem [proxy properties](/llm/markdown/app/references/proxy-configuration.md) `http_proxy`, `https_proxy` and `no_proxy` are respected for the download of the Cypress binary. You can also use the npm properties `npm_config_proxy` and `npm_config_https_proxy`. Those have lower priority, so they will only be used if the system properties are being resolved to not use a proxy.\n",
      "section": "app",
      "anchors": [
        "proxy-configuration"
      ],
      "path": "/llm/json/chunked/app/references/advanced-installation.json",
      "token_estimate": 68
    },
    {
      "id": "app/references/advanced-installation#install-binary",
      "doc_id": "app/references/advanced-installation",
      "heading": "Install binary",
      "heading_level": 2,
      "content_markdown": "## Install binary\n\nUsing the `CYPRESS_INSTALL_BINARY` environment variable, you can control how Cypress is installed. To override what is installed, you set `CYPRESS_INSTALL_BINARY` alongside the `npm install` command.\n\n**This is helpful if you want to:**\n\n*   Install a version different than the default npm package.\n    \n    ```\n    CYPRESS_INSTALL_BINARY=13.7.0 npm install cypress@13.7.1\n    ```\n    \n*   Specify an external URL (to bypass a corporate firewall).\n    \n    ```\n    CYPRESS_INSTALL_BINARY=https://company.domain.com/cypress.zip npm install cypress\n    ```\n    \n*   Specify a file to install locally instead of using the internet.\n    \n    ```\n    CYPRESS_INSTALL_BINARY=/local/path/to/cypress.zip npm install cypress\n    ```\n    \n\nIn all cases, the fact that the binary was installed from a custom location _is not saved in your `package.json` file_. Every repeated installation needs to use the same environment variable to install the same binary.\n\n### Skipping installation\n\nYou can also force Cypress to skip the installation of the binary application by setting `CYPRESS_INSTALL_BINARY=0`. This could be useful if you want to prevent Cypress from downloading the Cypress binary at the time of `npm install`.\n\n```\nCYPRESS_INSTALL_BINARY=0 npm install\n```\n\nNow Cypress will skip its install phase once the npm module is installed.\n\n### Troubleshoot installation\n\nThe Cypress [Life Cycle script](https://docs.npmjs.com/cli/using-npm/scripts) `postinstall` installs the Cypress binary after the [Cypress npm module](https://www.npmjs.com/package/cypress) has been installed. Package managers however execute the `postinstall` step in the background by default which hides the debug output. Execute `cypress install` separately with [debug logging](/llm/markdown/app/references/troubleshooting.md#Log-sources) enabled to view the debug logs.\n\n*   npm\n*   Yarn\n*   pnpm\n\n```\nCYPRESS_INSTALL_BINARY=0 npm install cypress --save-devDEBUG=cypress:cli* npx cypress install\n```\n\n```\nCYPRESS_INSTALL_BINARY=0 yarn add cypress --devDEBUG=cypress:cli* yarn cypress install\n```\n\n```\nCYPRESS_INSTALL_BINARY=0 pnpm add --save-dev cypressDEBUG=cypress:cli* pnpm cypress install\n```\n\nTo set environment variables `CYPRESS_INSTALL_BINARY` and `DEBUG` in Windows CMD or PowerShell terminals, refer to examples in [Print DEBUG Logs](/llm/markdown/app/references/troubleshooting.md#Print-DEBUG-logs).\n\nIn Continuous Integration (CI) use the following commands to display debug logs from the Cypress binary installation:\n\n*   npm\n*   Yarn\n*   pnpm\n\n```\nDEBUG=cypress:cli* npm ci --foreground-scripts\n```\n\n```\nyarn install --frozen-lockfile --ignore-scripts # Yarn v1 Classic onlyDEBUG=cypress:cli* yarn cypress install\n```\n\n```\npnpm install --frozen-lockfile --ignore-scriptsDEBUG=cypress:cli* pnpm cypress install\n```\n",
      "section": "app",
      "anchors": [
        "install-binary"
      ],
      "path": "/llm/json/chunked/app/references/advanced-installation.json",
      "token_estimate": 451
    },
    {
      "id": "app/references/advanced-installation#skipping-installation",
      "doc_id": "app/references/advanced-installation",
      "heading": "Skipping installation",
      "heading_level": 3,
      "content_markdown": "### Skipping installation\n\nYou can also force Cypress to skip the installation of the binary application by setting `CYPRESS_INSTALL_BINARY=0`. This could be useful if you want to prevent Cypress from downloading the Cypress binary at the time of `npm install`.\n\n```\nCYPRESS_INSTALL_BINARY=0 npm install\n```\n\nNow Cypress will skip its install phase once the npm module is installed.\n",
      "section": "app",
      "anchors": [
        "skipping-installation"
      ],
      "path": "/llm/json/chunked/app/references/advanced-installation.json",
      "token_estimate": 77
    },
    {
      "id": "app/references/advanced-installation#troubleshoot-installation",
      "doc_id": "app/references/advanced-installation",
      "heading": "Troubleshoot installation",
      "heading_level": 3,
      "content_markdown": "### Troubleshoot installation\n\nThe Cypress [Life Cycle script](https://docs.npmjs.com/cli/using-npm/scripts) `postinstall` installs the Cypress binary after the [Cypress npm module](https://www.npmjs.com/package/cypress) has been installed. Package managers however execute the `postinstall` step in the background by default which hides the debug output. Execute `cypress install` separately with [debug logging](/llm/markdown/app/references/troubleshooting.md#Log-sources) enabled to view the debug logs.\n\n*   npm\n*   Yarn\n*   pnpm\n\n```\nCYPRESS_INSTALL_BINARY=0 npm install cypress --save-devDEBUG=cypress:cli* npx cypress install\n```\n\n```\nCYPRESS_INSTALL_BINARY=0 yarn add cypress --devDEBUG=cypress:cli* yarn cypress install\n```\n\n```\nCYPRESS_INSTALL_BINARY=0 pnpm add --save-dev cypressDEBUG=cypress:cli* pnpm cypress install\n```\n\nTo set environment variables `CYPRESS_INSTALL_BINARY` and `DEBUG` in Windows CMD or PowerShell terminals, refer to examples in [Print DEBUG Logs](/llm/markdown/app/references/troubleshooting.md#Print-DEBUG-logs).\n\nIn Continuous Integration (CI) use the following commands to display debug logs from the Cypress binary installation:\n\n*   npm\n*   Yarn\n*   pnpm\n\n```\nDEBUG=cypress:cli* npm ci --foreground-scripts\n```\n\n```\nyarn install --frozen-lockfile --ignore-scripts # Yarn v1 Classic onlyDEBUG=cypress:cli* yarn cypress install\n```\n\n```\npnpm install --frozen-lockfile --ignore-scriptsDEBUG=cypress:cli* pnpm cypress install\n```\n",
      "section": "app",
      "anchors": [
        "troubleshoot-installation"
      ],
      "path": "/llm/json/chunked/app/references/advanced-installation.json",
      "token_estimate": 212
    },
    {
      "id": "app/references/advanced-installation#binary-cache",
      "doc_id": "app/references/advanced-installation",
      "heading": "Binary cache",
      "heading_level": 2,
      "content_markdown": "## Binary cache\n\nCypress downloads the matching Cypress binary to the global system cache, so that the binary can be shared between projects. By default, global cache folders are:\n\n*   **MacOS**: `~/Library/Caches/Cypress`\n*   **Linux**: `~/.cache/Cypress`\n*   **Windows**: `/AppData/Local/Cypress/Cache`\n\nTo override the default cache folder, set the environment variable `CYPRESS_CACHE_FOLDER`.\n\n```\nCYPRESS_CACHE_FOLDER=~/Desktop/cypress_cache npm install\n```\n\n```\nCYPRESS_CACHE_FOLDER=~/Desktop/cypress_cache npm run test\n```\n\nCypress will automatically replace the `~` with the user's home directory. So you can pass `CYPRESS_CACHE_FOLDER` as a string from CI configuration files, for example:\n\n```\nenvironment:  CYPRESS_CACHE_FOLDER: '~/.cache/Cypress'\n```\n\nSee also [Continuous Integration - Caching](/llm/markdown/app/continuous-integration/overview.md#Caching) section in the documentation.\n\n`CYPRESS_CACHE_FOLDER` will need to exist every time cypress is launched. To ensure this, consider exporting this environment variable. For example, in a `.bash_profile` (MacOS, Linux), or using `RegEdit` (Windows).\n",
      "section": "app",
      "anchors": [
        "binary-cache"
      ],
      "path": "/llm/json/chunked/app/references/advanced-installation.json",
      "token_estimate": 172
    },
    {
      "id": "app/references/advanced-installation#run-binary",
      "doc_id": "app/references/advanced-installation",
      "heading": "Run binary",
      "heading_level": 2,
      "content_markdown": "## Run binary\n\nSetting the environment variable `CYPRESS_RUN_BINARY` overrides where the npm module finds the Cypress binary.\n\n`CYPRESS_RUN_BINARY` should be a path to an already unzipped Cypress binary executable. The Cypress commands [open](/llm/markdown/app/references/command-line.md#cypress-open), [run](/llm/markdown/app/references/command-line.md#cypress-run) and [verify](/llm/markdown/app/references/command-line.md#cypress-verify) will then launch the provided binary.\n\nThe following example [cypress run](/llm/markdown/app/references/command-line.md#cypress-run) commands assume that you have first downloaded the Cypress binary to the default `Downloads` directory of your operating system.\n\nDepending on how you then unzip the downloaded Cypress binary `cypress.zip` file, using a CLI command or alternatively a GUI interface, the directory structure may include one additional top-level directory named `cypress`, which you may need to add to the path defined by `CYPRESS_RUN_BINARY`.\n\nIf available, use the following to avoid the additional top-level directory level:\n\n```\nunzip -q cypress\n```\n\nThe examples below are for npm. If you are using Yarn or pnpm as package manager, replace `npx` with `yarn` or `pnpm` as appropriate. See [How to run commands](/llm/markdown/app/references/command-line.md#How-to-run-commands).\n\n### Mac\n\n```\nCYPRESS_RUN_BINARY=~/Downloads/Cypress.app/Contents/MacOS/Cypress npx cypress run\n```\n\n### Linux\n\n```\nCYPRESS_RUN_BINARY=~/Downloads/Cypress/Cypress npx cypress run\n```\n\n### Windows\n\n```\nCYPRESS_RUN_BINARY=~/Downloads/Cypress/Cypress.exe npx cypress run\n```\n\nCypress assumes that `CYPRESS_RUN_BINARY` points to a writeable directory structure so that it can save and re-use the results of verifying the Cypress binary. If you encounter a `permission denied` failure message from [cypress verify](/llm/markdown/app/references/command-line.md#cypress-verify), you may be able to work around the failure by setting the environment variable `CYPRESS_SKIP_VERIFY` to `true`.\n",
      "section": "app",
      "anchors": [
        "run-binary"
      ],
      "path": "/llm/json/chunked/app/references/advanced-installation.json",
      "token_estimate": 309
    },
    {
      "id": "app/references/advanced-installation#windows",
      "doc_id": "app/references/advanced-installation",
      "heading": "Windows",
      "heading_level": 3,
      "content_markdown": "### Windows\n\n```\nCYPRESS_RUN_BINARY=~/Downloads/Cypress/Cypress.exe npx cypress run\n```\n\nCypress assumes that `CYPRESS_RUN_BINARY` points to a writeable directory structure so that it can save and re-use the results of verifying the Cypress binary. If you encounter a `permission denied` failure message from [cypress verify](/llm/markdown/app/references/command-line.md#cypress-verify), you may be able to work around the failure by setting the environment variable `CYPRESS_SKIP_VERIFY` to `true`.\n",
      "section": "app",
      "anchors": [
        "windows"
      ],
      "path": "/llm/json/chunked/app/references/advanced-installation.json",
      "token_estimate": 80
    },
    {
      "id": "app/references/advanced-installation#download-urls",
      "doc_id": "app/references/advanced-installation",
      "heading": "Download URLs",
      "heading_level": 2,
      "content_markdown": "## Download URLs\n\nIf you want to download a specific Cypress version for a given platform (Operating System), you can get it from our CDN.\n\nThe download server URL is `https://download.cypress.io`.\n\nWe currently have the following downloads available:\n\n*   Windows 64-bit (`?platform=win32&arch=x64`)\n*   Linux 64-bit (`?platform=linux`)\n*   macOS 64-bit (`?platform=darwin`)\n\nHere are the available download URLs:\n\nSee [https://download.cypress.io/desktop.json](https://download.cypress.io/desktop.json) for all available platforms.\n\n| Method | URL | Description |\n| --- | --- | --- |\n| `GET` | `/desktop` | Download Cypress at latest version (platform auto-detected) |\n| `GET` | `/desktop.json` | Returns JSON containing latest available CDN destinations |\n| `GET` | `/desktop?platform=p&arch=a` | Download Cypress for a specific platform and/or architecture |\n| `GET` | `/desktop/:version` | Download Cypress with a specified version |\n| `GET` | `/desktop/:version?platform=p&arch=a` | Download Cypress with a specified version and platform and/or architecture |\n\n**Example of downloading Cypress `12.17.4` for Windows 64-bit:**\n\n```\nhttps://download.cypress.io/desktop/12.17.4?platform=win32&arch=x64\n```\n",
      "section": "app",
      "anchors": [
        "download-urls"
      ],
      "path": "/llm/json/chunked/app/references/advanced-installation.json",
      "token_estimate": 207
    },
    {
      "id": "app/references/advanced-installation#mirroring",
      "doc_id": "app/references/advanced-installation",
      "heading": "Mirroring",
      "heading_level": 2,
      "content_markdown": "## Mirroring\n\nIf you choose to mirror the entire Cypress download site, you can specify `CYPRESS_DOWNLOAD_MIRROR` to set the download server URL from `https://download.cypress.io` to your own mirror.\n\nFor example:\n\n```\nCYPRESS_DOWNLOAD_MIRROR=\"https://www.example.com\" cypress install\n```\n\nCypress will then attempt to download a binary with this format: `https://www.example.com/desktop/:version?platform=p`\n",
      "section": "app",
      "anchors": [
        "mirroring"
      ],
      "path": "/llm/json/chunked/app/references/advanced-installation.json",
      "token_estimate": 63
    },
    {
      "id": "app/references/advanced-installation#download-path-template",
      "doc_id": "app/references/advanced-installation",
      "heading": "Download path template",
      "heading_level": 2,
      "content_markdown": "## Download path template\n\nYou can use the `CYPRESS_DOWNLOAD_PATH_TEMPLATE` environment variable to download the Cypress binary from a custom URL that's generated based on endpoint, version, platform and architecture.\n\n**The following replacements are supported:**\n\n*   `${endpoint}` is replaced with `https://download.cypress.io/desktop/:version`. If `CYPRESS_DOWNLOAD_MIRROR` is set, its value is used instead of `https://download.cypress.io` (note that the `/desktop` remains!)\n*   `${platform}` is replaced with the platform the installation is running on (e.g. `win32`, `linux`, `darwin`)\n*   `${arch}` is replaced with the architecture the installation is running on (e.g. `x64`, `arm64`)\n*   `${version}` is replaced with the version number that's being installed (e.g. `10.11.0`)\n\n**Examples:**\n\nTo install the binary from a download mirror that matches the exact file structure of `https://cdn.cypress.io`:\n\n```\nexport CYPRESS_DOWNLOAD_MIRROR=https://cypress-download.localexport CYPRESS_DOWNLOAD_PATH_TEMPLATE='${endpoint}/${platform}-${arch}/cypress.zip'# Example of a resulting URL: https://cypress-download.local/desktop/10.11.0/linux-x64/cypress.zip\n```\n\nTo install the binary from a download server with a custom file structure:\n\n```\nexport CYPRESS_DOWNLOAD_PATH_TEMPLATE='https://software.local/cypress/${platform}/${arch}/${version}/cypress.zip'# Example of a resulting URL: https://software.local/cypress/linux/x64/10.11.0/cypress.zip\n```\n\nTo define `CYPRESS_DOWNLOAD_PATH_TEMPLATE` in `.npmrc`, put a backslash before every `$`:\n\n```\nCYPRESS_DOWNLOAD_PATH_TEMPLATE=\\${endpoint}/\\${platform}-\\${arch}/cypress.zip\n```\n",
      "section": "app",
      "anchors": [
        "download-path-template"
      ],
      "path": "/llm/json/chunked/app/references/advanced-installation.json",
      "token_estimate": 220
    },
    {
      "id": "app/references/advanced-installation#using-a-custom-certificate-authority-ca",
      "doc_id": "app/references/advanced-installation",
      "heading": "Using a custom certificate authority (CA)",
      "heading_level": 2,
      "content_markdown": "## Using a custom certificate authority (CA)\n\nCypress can be configured to use the `ca` and `cafile` options from your npm config file to download the Cypress binary.\n\nFor example, to use the CA at `/home/person/certs/ca.crt` when downloading Cypress, add the following to your `.npmrc`:\n\n```\ncafile=/home/person/certs/ca.crt\n```\n\nIf neither `cafile` nor `ca` are set, Cypress looks at the system environment variable `NODE_EXTRA_CA_CERTS` and uses the corresponding certificate(s) as an extension for the trusted certificate authority when downloading the Cypress binary.\n\nNote that the npm config is used as a replacement, and the node environment variable is used as an extension.\n",
      "section": "app",
      "anchors": [
        "using-a-custom-certificate-authority-ca"
      ],
      "path": "/llm/json/chunked/app/references/advanced-installation.json",
      "token_estimate": 135
    },
    {
      "id": "app/references/advanced-installation#opt-out-of-sending-exception-data-to-cypress",
      "doc_id": "app/references/advanced-installation",
      "heading": "Opt out of sending exception data to Cypress",
      "heading_level": 2,
      "content_markdown": "## Opt out of sending exception data to Cypress\n\nWhen an exception is thrown regarding Cypress, we send along the exception data to `https://api.cypress.io`. We solely use this information to help develop a better product.\n\nIf you would like to opt out of sending any exception data to Cypress, you can do so by setting `CYPRESS_CRASH_REPORTS=0` in your system environment variables.\n\n### Opt out on Linux or macOS\n\nTo opt out of sending exception data on Linux or macOS, run the following command in a terminal before installing Cypress:\n\n```\nexport CYPRESS_CRASH_REPORTS=0\n```\n\nTo make these changes permanent, you can add this command to your shell's `~/.profile` (`~/.zsh_profile`, `~/.bash_profile`, etc.) to run them on every login.\n\n### Opt out on Windows\n\nTo opt out of sending exception data on Windows, run the following command in the Command Prompt before installing Cypress:\n\n```\nset CYPRESS_CRASH_REPORTS=0\n```\n\nTo accomplish the same thing in PowerShell:\n\n```\n$env:CYPRESS_CRASH_REPORTS = \"0\"\n```\n\nTo save the `CYPRESS_CRASH_REPORTS` variable for use in all new shells, use `setx`:\n\n```\nsetx CYPRESS_CRASH_REPORTS 0\n```\n",
      "section": "app",
      "anchors": [
        "opt-out-of-sending-exception-data-to-cypress"
      ],
      "path": "/llm/json/chunked/app/references/advanced-installation.json",
      "token_estimate": 233
    },
    {
      "id": "app/references/advanced-installation#opt-out-on-linux-or-macos",
      "doc_id": "app/references/advanced-installation",
      "heading": "Opt out on Linux or macOS",
      "heading_level": 3,
      "content_markdown": "### Opt out on Linux or macOS\n\nTo opt out of sending exception data on Linux or macOS, run the following command in a terminal before installing Cypress:\n\n```\nexport CYPRESS_CRASH_REPORTS=0\n```\n\nTo make these changes permanent, you can add this command to your shell's `~/.profile` (`~/.zsh_profile`, `~/.bash_profile`, etc.) to run them on every login.\n",
      "section": "app",
      "anchors": [
        "opt-out-on-linux-or-macos"
      ],
      "path": "/llm/json/chunked/app/references/advanced-installation.json",
      "token_estimate": 73
    },
    {
      "id": "app/references/advanced-installation#opt-out-on-windows",
      "doc_id": "app/references/advanced-installation",
      "heading": "Opt out on Windows",
      "heading_level": 3,
      "content_markdown": "### Opt out on Windows\n\nTo opt out of sending exception data on Windows, run the following command in the Command Prompt before installing Cypress:\n\n```\nset CYPRESS_CRASH_REPORTS=0\n```\n\nTo accomplish the same thing in PowerShell:\n\n```\n$env:CYPRESS_CRASH_REPORTS = \"0\"\n```\n\nTo save the `CYPRESS_CRASH_REPORTS` variable for use in all new shells, use `setx`:\n\n```\nsetx CYPRESS_CRASH_REPORTS 0\n```\n",
      "section": "app",
      "anchors": [
        "opt-out-on-windows"
      ],
      "path": "/llm/json/chunked/app/references/advanced-installation.json",
      "token_estimate": 79
    },
    {
      "id": "app/references/advanced-installation#opt-out-of-cypress-commercial-messaging",
      "doc_id": "app/references/advanced-installation",
      "heading": "Opt out of Cypress commercial messaging",
      "heading_level": 2,
      "content_markdown": "## Opt out of Cypress commercial messaging\n\nCypress may occasionally display messages in your CI logs related to our commercial offerings and how they could benefit you during your workflows.\n\nIf you would like to opt out of all commercial messaging, you can do so by setting `CYPRESS_COMMERCIAL_RECOMMENDATIONS=0` in your system environment variables.\n",
      "section": "app",
      "anchors": [
        "opt-out-of-cypress-commercial-messaging"
      ],
      "path": "/llm/json/chunked/app/references/advanced-installation.json",
      "token_estimate": 71
    },
    {
      "id": "app/references/advanced-installation#install-pre-release-version",
      "doc_id": "app/references/advanced-installation",
      "heading": "Install pre-release version",
      "heading_level": 2,
      "content_markdown": "## Install pre-release version\n\nIf you would like to install a pre-release version of Cypress to test out functionality that has not yet been released, here is how:\n\n1.  Open up the list of commits to `develop` on the Cypress repo: [https://github.com/cypress-io/cypress/commits/develop](https://github.com/cypress-io/cypress/commits/develop)\n2.  Find the commit that you would like to install the pre-release version of. Click the comment icon (highlighted in red below):\n    \n3.  You should see several comments from the `cypress-bot` user with instructions for installing Cypress pre-releases. Pick the one that corresponds to your operating system and CPU architecture, and follow the instructions there to install the pre-release.\n\nCypress pre-releases are only available for 60 days after they are built. Do not rely on these being available past 60 days.\n",
      "section": "app",
      "anchors": [
        "install-pre-release-version"
      ],
      "path": "/llm/json/chunked/app/references/advanced-installation.json",
      "token_estimate": 164
    },
    {
      "id": "app/references/advanced-installation#windows-subsystem-for-linux",
      "doc_id": "app/references/advanced-installation",
      "heading": "Windows Subsystem for Linux",
      "heading_level": 2,
      "content_markdown": "## Windows Subsystem for Linux\n\nCypress requires an [X-server](https://en.wikipedia.org/wiki/X.Org_Server) (X11) to display the Cypress UI from a Windows Subsystem for Linux installation. This requirement is met by current versions of Windows Subsystem for Linux (WSL2) with X11 support being included through Windows Subsystem for Linux GUI (WSLg).\n\nRefer to [GitHub: Windows Subsystem for Linux GUI (WSLg)](https://github.com/microsoft/wslg) for installation instructions on Ubuntu and install the [prerequisite Linux packages](/llm/markdown/app/get-started/install-cypress.md#Linux-Prerequisites) before running Cypress.\n\nRefer to Microsoft Learn [Windows Subsystem for Linux Documentation](https://learn.microsoft.com/en-us/windows/wsl/) for additional information.\n\nCypress.io does not specifically support the use of Cypress under Windows Subsystem for Linux (WSL). If you want to report an issue, please ensure that you can reproduce it without using WSL on one of the Cypress [supported operating systems](/llm/markdown/app/get-started/install-cypress.md#Operating-System).\n",
      "section": "app",
      "anchors": [
        "windows-subsystem-for-linux"
      ],
      "path": "/llm/json/chunked/app/references/advanced-installation.json",
      "token_estimate": 163
    },
    {
      "id": "app/references/advanced-installation#uninstall-cypress",
      "doc_id": "app/references/advanced-installation",
      "heading": "Uninstall Cypress",
      "heading_level": 2,
      "content_markdown": "## Uninstall Cypress\n\nTo uninstall Cypress from a project, use the same package manager you used to [install Cypress](/llm/markdown/app/get-started/install-cypress.md):\n\n*   npm\n*   Yarn\n*   pnpm\n\n```\nnpm uninstall cypress\n```\n\n```\nyarn remove cypress\n```\n\n```\npnpm remove cypress\n```\n\nTo uninstall all cached Cypress binary versions, use the [cypress cache clear](/llm/markdown/app/references/command-line.md#cypress-cache-clear) command with the appropriate package manager prefix described in [How to run commands](/llm/markdown/app/references/command-line.md#How-to-run-commands). Alternatively, delete the [Cypress binary cache](#Binary-cache) (see above) manually.\n\nTo delete cached [Cypress App Data](/llm/markdown/app/references/troubleshooting.md#Clear-App-Data), manually delete the following directories / folders:\n\n*   macOS: `~/Library/Application Support/Cypress`\n*   Linux: `~/.config/Cypress`\n*   Windows: `$APPDATA/Cypress` (POSIX-syntax) or `%APPDATA%\\Cypress` (Windows-syntax)\n\nRefer to your package manager documentation for details of package manager `cache clean` commands to remove other packages cached by npm, Yarn or pnpm.\n",
      "section": "app",
      "anchors": [
        "uninstall-cypress"
      ],
      "path": "/llm/json/chunked/app/references/advanced-installation.json",
      "token_estimate": 167
    }
  ]
}