{"id":14989891,"url":"https://github.com/curl/curl-container","last_synced_at":"2025-03-16T07:08:37.453Z","repository":{"id":173088017,"uuid":"619162659","full_name":"curl/curl-container","owner":"curl","description":"curl images","archived":false,"fork":false,"pushed_at":"2024-09-18T07:06:47.000Z","size":99,"stargazers_count":66,"open_issues_count":11,"forks_count":12,"subscribers_count":7,"default_branch":"main","last_synced_at":"2024-10-29T15:32:24.846Z","etag":null,"topics":["containers","curl"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/curl.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","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},"funding":{"github":"curl","open_collective":"curl"}},"created_at":"2023-03-26T13:07:44.000Z","updated_at":"2024-10-28T16:48:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"515011ed-ca5d-4982-b410-02318881b321","html_url":"https://github.com/curl/curl-container","commit_stats":{"total_commits":48,"total_committers":4,"mean_commits":12.0,"dds":0.08333333333333337,"last_synced_commit":"04061b6d5653f5d9c4823a6ff0e199a2f0e5ae49"},"previous_names":["curl/curl-container"],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/curl%2Fcurl-container","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/curl%2Fcurl-container/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/curl%2Fcurl-container/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/curl%2Fcurl-container/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/curl","download_url":"https://codeload.github.com/curl/curl-container/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242216641,"owners_count":20091059,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["containers","curl"],"created_at":"2024-09-24T14:19:05.606Z","updated_at":"2025-03-16T07:08:37.434Z","avatar_url":"https://github.com/curl.png","language":"Shell","funding_links":["https://github.com/sponsors/curl","https://opencollective.com/curl"],"categories":[],"sub_categories":[],"readme":"# Curl Container\n\n[![build_master_multi_images](https://github.com/curl/curl-container/actions/workflows/build_master_multi.yml/badge.svg)](https://github.com/curl/curl-container/actions/workflows/build_master_multi.yml) \n[![build_latest_release_multi_images](https://github.com/curl/curl-container/actions/workflows/build_latest_release_multi.yml/badge.svg)](https://github.com/curl/curl-container/actions/workflows/build_latest_release_multi.yml)\n\nThis repository contains infrastructure/code that generates, tests and distributes the Official curl docker images \navailable from the following registries:\n* [quay.io](https://quay.io/curl/curl): curl images distributed by Quay.io\n* [docker.io](https://hub.docker.com/r/curlimages/curl): curl images distributed by docker.io\n* [github packages](https://github.com/orgs/curl/packages): development curl images\n\nTo pull an image:\n```\n\u003e podman pull quay.io/curl/curl:latest\n```\nTo run an image:\n```\n\u003e podman run -it quay.io/curl/curl:latest -V\n```\n\nTo use base image:\n```\nfrom quay.io/curl/curl-base:latest\nRUN apk add jq\n```\n\n## Known limitations\n\n- **IPv6 is supported**, however Docker/Podman do not support out by default.\n  IPv6 must be enabled on network-level within Docker/Podman.\n\n## How to verify images\n\nTo view curl image signature use [sigstore](https://sigstore.dev) `cosign tree`:\n```commandline\n\u003e cosign tree ghcr.io/curl/curl-container/curl:master\n```\nImages are verified with this [public key](https://github.com/curl/curl-container/blob/main/cosign.pub):\n```commandline\n-----BEGIN PUBLIC KEY-----\nMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEwFTRXl79xRiAFa5ZX4aZ7Vkdqmji\n5WY0zqc3bd6B08CsNftlYsu2gAqdWm0IlzoQpi2Zi5C437RTg/DgLQ6Bkg==\n-----END PUBLIC KEY-----\n```\nVerify image using [cosign.pub](cosign.pub) public key using [sigstore](https://sigstore.dev) `cosign verify`:\n```\n\u003e cosign verify --key cosign.pub ghcr.io/curl/curl-container/curl:master\n```\n\n## Contact\n\nIf you have problems, questions, ideas or suggestions, please [raise an issue](https://github.com/curl/curl-container/issues) or contact [curl-container team](curl-container@curl.se)\nor [Jim Fuller](jim.fuller@webcomposite.com) directly.\n\n## Development curl images\n\nThe following images are available via [github packages](https://github.com/orgs/curl/packages).\n\nMaster branch built regularly:\n* **curl-dev:master** - curl-dev **master** branch \n* **curl-base:master** - curl-base **master** branch\n* **curl:master** - curl **master** branch\n* **curl-multi:master** - curl multiarch **master** branch\n* **curl-base-multi:master** - curl-base multiarch **master** branch\n\nA set of special case images built regularly:\n* **curl-exp:master** - curl **master** branch built enabling expiremental features\n\nPlatform specific dev images built daily:\n* **curl-dev:master** - alpine based development environment\n* **curl-dev-debian:master** - debian based development environment\n* **curl-dev-fedora:master** - fedora based development environment\n\nTo use any of these development images; \n```\n\u003e podman run -it -v /Users/exampleuser/src/curl:/src/curl  ghcr.io/curl/curl-container/curl-dev-debian:master zsh\n\u003e ./buildconf\n\u003e ./configure\n\u003e make\n```\n\n**Note**- dev images are not specifically scanned for vulnerabilities and we currently _pin_ to latest which \nalways has vulns ... **use at your own risk**. Perhaps we could consider _pinning_ to a later 'vintage'.\n\n## Dependencies\n\nEither of the following are required to use images:\n* [podman](https://podman.io/getting-started/) \n* [docker](https://docs.docker.com/get-docker/)\n\nThe following are required to build or release images: \n* [buildah](https://buildah.io/): used for composing dev/build images\n* [qemu-user-static](https://github.com/multiarch/qemu-user-static): used for building multiarch images\n\n## Release\n\nCurl images roughly match curl own release schedule, though we may release multiple versions\nof the same curl version. In that instance we append a number (ex. 8.1.2-1) though do not rev\nthe version number used in registries.\n\nThe release process is as follows:\n\n* create new branch (ex. v8.1.2)\n* update [VERSION](https://github.com/curl/curl-container/blob/main/VERSION) to match curl version\n* update [CHANGELOG.md](https://github.com/curl/curl-container/blob/main/CHANGELOG.md)\n* raise prep PR, review and merge\n* create [new release](https://github.com/curl/curl-container/releases/new) with new tag ( ex. 8.1.2 ) based on previously created branch\n* new tag will trigger CI for publishing to quay/docker\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcurl%2Fcurl-container","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcurl%2Fcurl-container","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcurl%2Fcurl-container/lists"}