curlimages/curl

Official curl docker images

These are the official curl images generated by the curl docker team (curl-docker at haxx.se) or contact Jim Fuller (jim at webcomposite.com)

Latest image is also available from https://quay.io/repository/curl/curl.

Latest tags and respective Dockerfile links

• https://github.com/curl/curl-container/releases/tag/8.21.0 - bump curl 8.21.0 and bump alpine 3.24.1

Quick reference

• Where to get help: website, mailing lists, Everything Curl
• github repo: https://github.com/curl/curl-container
• Where to file issues: https://github.com/curl/curl-container/issues
• Maintained by: The curl docker team (curl-container at curl.se)
• License(s) - license, check 3rd party documentation for license information

What is Curl ?

curl is a command line tool and library for transferring data with URLs.

curl is used in command lines or scripts to transfer data. It is also used in cars, television sets, routers, printers, audio equipment, mobile phones, tablets, settop boxes, media players and is the internet transfer backbone for thousands of software applications affecting billions of humans daily.

Supports the following protocols (so far!):.

DICT, FILE, FTP, FTPS, Gopher, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, POP3, POP3S, RTMP, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, Telnet and TFTP. curl supports SSL certificates, HTTP POST, HTTP PUT, FTP uploading, HTTP form based upload, proxies, HTTP/2, cookies, user+password authentication (Basic, Plain, Digest, CRAM-MD5, NTLM, Negotiate and Kerberos), file transfer resume, proxy tunnelling and more.

How to use this image

getting docker image

To pull the latest version:

> docker pull curlimages/curl:8.21.0

run docker image

Check everything works properly by running:

> docker run --rm curlimages/curl:8.21.0 --version

Here is a more specific example of running curl docker container:

> docker run --rm curlimages/curl:8.21.0 -L -v https://curl.se 

To work with files it is best to mount directory:

>  docker run --rm -it -v "$PWD:/work" curlimages/curl:8.21.0 -d@/work/test.txt https://httpbin.org/post

Looking for a base image to use ? go over to https://hub.docker.com/repository/docker/curlimages/curl/general.

Build

This version of curl built with the following configure options

--enable-static --disable-ldap --enable-ipv6 --enable-unix-sockets --with-ssl --with-libssh2 --with-nghttp2=/usr \
--prefix=/usr/local --with-gssapi

supporting:

Protocols: dict file ftp ftps gopher gophers http https imap imaps mqtt pop3 pop3s rtsp scp sftp smb smbs smtp smtps telnet tftp
Features: alt-svc AsynchDNS brotli HTTP2 HTTPS-proxy IPv6 Largefile libz NTLM NTLM_WB SSL TLS-SRP UnixSockets

How to verify image

Images are signed using https://www.sigstore.dev/. To view signatures of the image:

cosign tree curlimages/curl:8.21.0

Images are signed with cosign and can be verified with this public key:

-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEwFTRXl79xRiAFa5ZX4aZ7Vkdqmji
5WY0zqc3bd6B08CsNftlYsu2gAqdWm0IlzoQpi2Zi5C437RTg/DgLQ6Bkg==
-----END PUBLIC KEY-----

Save this to a file (ex. cosign.pub) and verify with cosign as follows:

cosign verify --key cosign.pub curlimages/curl:8.21.0