{"id":36955362,"url":"https://github.com/atos-actions/download-artifact","last_synced_at":"2026-04-02T15:38:34.003Z","repository":{"id":200388076,"uuid":"494468893","full_name":"atos-actions/download-artifact","owner":"atos-actions","description":"Download and untar a build artifact that was previously uploaded in the workflow by the upload-artifact action","archived":false,"fork":false,"pushed_at":"2026-01-01T23:04:45.000Z","size":1223,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-07T10:45:55.839Z","etag":null,"topics":["actions","artifacts","atos","download","eviden","github","tar"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/atos-actions.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-05-20T13:10:49.000Z","updated_at":"2026-01-01T23:04:47.000Z","dependencies_parsed_at":null,"dependency_job_id":"ce6f7847-3d1e-4d61-8aca-0190de935ac1","html_url":"https://github.com/atos-actions/download-artifact","commit_stats":null,"previous_names":["eviden-actions/download-artifact","atos-actions/download-artifact"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/atos-actions/download-artifact","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atos-actions%2Fdownload-artifact","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atos-actions%2Fdownload-artifact/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atos-actions%2Fdownload-artifact/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atos-actions%2Fdownload-artifact/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/atos-actions","download_url":"https://codeload.github.com/atos-actions/download-artifact/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atos-actions%2Fdownload-artifact/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28385808,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T12:01:30.995Z","status":"ssl_error","status_checked_at":"2026-01-13T12:00:09.625Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["actions","artifacts","atos","download","eviden","github","tar"],"created_at":"2026-01-13T13:03:00.248Z","updated_at":"2026-03-03T13:04:06.914Z","avatar_url":"https://github.com/atos-actions.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Download-Artifact\n\nThis downloads artifacts from your build\nThis action is an extension of Github's [download-artifact](https://github.com/actions/download-artifact) action that `untar` the files after downloading.\n\nSee also [upload-artifact](https://github.com/atos-actions/upload-artifact).\n\n[![Release](https://github.com/atos-actions/download-artifact/actions/workflows/release.yml/badge.svg#main)](https://github.com/atos-actions/download-artifact/actions/workflows/release.yml)\n\n## v2 - What's new\n\n\u003e [!IMPORTANT]\n\u003e actions/download-artifact@v4+ is not currently supported on GHES yet. If you are on GHES, you must use [v1](https://github.com/atos-actions/download-artifact/releases/tag/v1).\n\nThe release of actions/upload-artifact@4 and actions/download-artifact@v4 are major changes to the backend architecture of Artifacts. They have numerous performance and behavioral improvements.\n\nFor more information, see the [`@actions/artifact`](https://github.com/actions/toolkit/tree/main/packages/artifact) documentation.\n\n### Improvements\n\n1. Downloads are significantly faster, upwards of 90% improvement in worst case scenarios.\n2. Artifacts can be downloaded from other workflow runs and repositories when supplied with a PAT.\n\n### Breaking Changes\n\n1. On self hosted runners, additional [firewall rules](https://github.com/actions/toolkit/tree/main/packages/artifact#breaking-changes) may be required.\n2. Downloading artifacts that were created from `action/upload-artifact@v3` and below are not supported.\n\nFor assistance with breaking changes, see [MIGRATION.md](docs/MIGRATION.md).\n\n## Usage\n\n### Inputs\n\n```yaml\n- uses: actions/download-artifact@v4\n  with:\n    # Name of the artifact to download.\n    # If unspecified, all artifacts for the run are downloaded.\n    # Optional.\n    name:\n\n    # Destination path. Supports basic tilde expansion.\n    # Optional. Default is $GITHUB_WORKSPACE\n    path:\n\n    # A glob pattern to the artifacts that should be downloaded.\n    # Ignored if name is specified.\n    # Optional.\n    pattern:\n\n    # When multiple artifacts are matched, this changes the behavior of the destination directories.\n    # If true, the downloaded artifacts will be in the same directory specified by path.\n    # If false, the downloaded artifacts will be extracted into individual named directories within the specified path.\n    # Optional. Default is 'false'\n    merge-multiple:\n\n    # The GitHub token used to authenticate with the GitHub API.\n    # This is required when downloading artifacts from a different repository or from a different workflow run.\n    # Optional. If unspecified, the action will download artifacts from the current repo and the current workflow run.\n    github-token:\n\n    # The repository owner and the repository name joined together by \"/\".\n    # If github-token is specified, this is the repository that artifacts will be downloaded from.\n    # Optional. Default is ${{ github.repository }}\n    repository:\n\n    # The id of the workflow run where the desired download artifact was uploaded from.\n    # If github-token is specified, this is the run that artifacts will be downloaded from.\n    # Optional. Default is ${{ github.run_id }}\n    run-id:\n```\n\n### Outputs\n\n| Name            | Description                                         | Example                 |\n| --------------- | --------------------------------------------------- | ----------------------- |\n| `download-path` | Absolute path where the artifact(s) were downloaded | `/tmp/my/download/path` |\n\n## Examples\n\n### Download Single Artifact\n\nDownload to current working directory (`$GITHUB_WORKSPACE`):\n\n```yaml\nsteps:\n  - uses: actions/download-artifact@v4\n    with:\n      name: my-artifact\n  - name: Display structure of downloaded files\n    run: ls -R\n```\n\nDownload to a specific directory (also supports `~` expansion):\n\n```yaml\nsteps:\n  - uses: actions/download-artifact@v4\n    with:\n      name: my-artifact\n      path: your/destination/dir\n  - name: Display structure of downloaded files\n    run: ls -R your/destination/dir\n```\n\n### Download All Artifacts\n\nIf the `name` input parameter is not provided, all artifacts will be downloaded. To differentiate between downloaded artifacts, by default a directory denoted by the artifacts name will be created for each individual artifact. This behavior can be changed with the `merge-multiple` input parameter.\n\nExample, if there are two artifacts `Artifact-A` and `Artifact-B`, and the directory is `etc/usr/artifacts/`, the directory structure will look like this:\n\n```\netc/usr/artifacts/\n    Artifact-A/\n        ... contents of Artifact-A\n    Artifact-B/\n        ... contents of Artifact-B\n```\n\nDownload all artifacts to the current working directory:\n\n```yaml\nsteps:\n  - uses: actions/download-artifact@v4\n  - name: Display structure of downloaded files\n    run: ls -R\n```\n\nDownload all artifacts to a specific directory:\n\n```yaml\nsteps:\n  - uses: actions/download-artifact@v4\n    with:\n      path: path/to/artifacts\n  - name: Display structure of downloaded files\n    run: ls -R path/to/artifacts\n```\n\nTo download them to the _same_ directory:\n\n```yaml\nsteps:\n  - uses: actions/download-artifact@v4\n    with:\n      path: path/to/artifacts\n      merge-multiple: true\n  - name: Display structure of downloaded files\n    run: ls -R path/to/artifacts\n```\n\nWhich will result in:\n\n```\npath/to/artifacts/\n    ... contents of Artifact-A\n    ... contents of Artifact-B\n```\n\n### Download multiple (filtered) Artifacts to the same directory\n\nIn multiple arch/os scenarios, you may have Artifacts built in different jobs. To download all Artifacts to the same directory (or matching a glob pattern), you can use the `pattern` and `merge-multiple` inputs.\n\n```yaml\njobs:\n  upload:\n    strategy:\n      matrix:\n        runs-on: [ubuntu-latest, macos-latest, windows-latest]\n    runs-on: ${{ matrix.runs-on }}\n    steps:\n      - name: Create a File\n        run: echo \"hello from ${{ matrix.runs-on }}\" \u003e file-${{ matrix.runs-on }}.txt\n      - name: Upload Artifact\n        uses: actions/upload-artifact@v4\n        with:\n          name: my-artifact-${{ matrix.runs-on }}\n          path: file-${{ matrix.runs-on }}.txt\n  download:\n    needs: upload\n    runs-on: ubuntu-latest\n    steps:\n      - name: Download All Artifacts\n        uses: actions/download-artifact@v4\n        with:\n          path: my-artifact\n          pattern: my-artifact-*\n          merge-multiple: true\n      - run: ls -R my-artifact\n```\n\nThis results in a directory like so:\n\n```\nmy-artifact/\n  file-macos-latest.txt\n  file-ubuntu-latest.txt\n  file-windows-latest.txt\n```\n\n### Download Artifacts from other Workflow Runs or Repositories\n\nIt may be useful to download Artifacts from other workflow runs, or even other repositories. By default, the permissions are scoped so they can only download Artifacts within the current workflow run. To elevate permissions for this scenario, you can specify a `github-token` along with other repository and run identifiers:\n\n```yaml\nsteps:\n  - uses: actions/download-artifact@v4\n    with:\n      name: my-other-artifact\n      github-token: ${{ secrets.GH_PAT }} # token with actions:read permissions on target repo\n      repository: actions/toolkit\n      run-id: 1234\n```\n\n## Limitations\n\n### Permission Loss\n\nFile permissions are not maintained during artifact upload. All directories will have `755` and all files will have `644`. For example, if you make a file executable using `chmod` and then upload that file, post-download the file is no longer guaranteed to be set as an executable.\n\nIf you must preserve permissions, you can `tar` all of your files together before artifact upload. Post download, the `tar` file will maintain file permissions and case sensitivity.\n\n```yaml\n- name: 'Tar files'\n  run: tar -cvf my_files.tar /path/to/my/directory\n\n- name: 'Upload Artifact'\n  uses: actions/upload-artifact@v4\n  with:\n    name: my-artifact\n    path: my_files.tar\n```\n\n## Additional Documentation\n\nSee [Github's download-artifact action](https://github.com/actions/updownload-artifact) for additional documentation.\n\nSee extra documentation for the [@actions/artifact](https://github.com/actions/toolkit/blob/main/packages/artifact/docs/additional-information.md) package that is used internally regarding certain behaviors and limitations.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatos-actions%2Fdownload-artifact","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fatos-actions%2Fdownload-artifact","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatos-actions%2Fdownload-artifact/lists"}