{"id":12811,"date":"2026-06-29T05:18:43","date_gmt":"2026-06-29T05:18:43","guid":{"rendered":"https:\/\/www.bodhost.com\/kb\/?p=12811"},"modified":"2026-06-29T13:40:39","modified_gmt":"2026-06-29T13:40:39","slug":"a-step-by-step-guide-how-to-install-curl-on-macosx","status":"publish","type":"post","link":"https:\/\/www.bodhost.com\/kb\/a-step-by-step-guide-how-to-install-curl-on-macosx\/","title":{"rendered":"How to Update curl on macOS (Step-by-Step Guide)"},"content":{"rendered":"

The fastest way to update curl on macOS is via Homebrew: run brew install curl,<\/span> then brew link curl –force<\/span>. This installs the latest curl version alongside the older system version that ships with macOS, without touching system files.<\/p>\n

macOS comes with curl pre-installed, but Apple often ships an older build with limited TLS\/SSL support. If you’ve hit version-related errors or need newer protocol support, here’s how to safely update it.<\/p>\n

Is curl pre-installed on macOS?<\/strong><\/h3>\n

Yes. Every modern version of macOS includes a system copy of curl at \/usr\/bin\/curl. You can confirm this \u2014 and check your version \u2014 with:<\/p>\n

curl –version<\/span><\/p><\/blockquote>\n

If the version shown is significantly older than the latest curl release, it’s worth updating, especially if you’ve encountered SSL handshake errors or warnings about unsupported protocols.<\/p>\n

Method 1: Update curl with Homebrew (Recommended)<\/strong><\/h4>\n

If you don’t have Homebrew yet, install it first:<\/p>\n

\/bin\/bash -c “$(curl -fsSL https:\/\/raw.githubusercontent.com\/Homebrew\/install\/HEAD\/install.sh)”<\/span><\/p><\/blockquote>\n

Then install or update curl:<\/p>\n

brew install curl<\/span>
\nbrew link curl –force<\/span><\/p><\/blockquote>\n

Homebrew installs its version of curl at\/opt\/homebrew\/bin\/curl<\/span> (Apple Silicon) or \/usr\/local\/bin\/curl<\/span> (Intel), leaving the system version untouched. Restart your terminal and re-check the version with curl –version;<\/span>\u00a0you should now see the updated number and an updated path.<\/p>\n

If curl was already installed via Homebrew, simply run:<\/p>\n

brew upgrade curl<\/span><\/p><\/blockquote>\n

Method 2: Update via MacPorts<\/strong><\/h4>\n

If you use MacPorts instead of Homebrew:<\/p>\n

sudo port selfupdate<\/span>
\nsudo port upgrade curl<\/span><\/p><\/blockquote>\n

Why You Shouldn’t Replace the System curl<\/strong><\/h3>\n

Don’t try to delete or overwrite \/usr\/bin\/curl<\/span> directly. macOS relies on it for internal scripts and security tools, and System Integrity Protection (SIP) blocks direct edits to it anyway. Always install the updated version to a separate path (which is exactly what Homebrew and MacPorts do) and let your shell’s PATH prioritize the new version.<\/p>\n

Fixing “curl: command not found”<\/strong><\/h4>\n

If your terminal returns command not found after installing curl, it’s almost always a PATH issue, not a missing binary. Check where curl is installed:<\/p>\n

which curl<\/span><\/p><\/blockquote>\n

Then make sure that directory is included in your shell’s PATH (in ~\/.zprofile or ~\/.bash_profile):<\/p>\n

export PATH=”\/opt\/homebrew\/bin:$PATH”<\/span><\/p><\/blockquote>\n

Reload your shell with source ~\/.zprofile<\/span> and try again.<\/p>\n

curl vs. libcurl<\/strong><\/h4>\n

curl is the command-line tool; libcurl is the underlying library that powers it (and that many programming languages use for HTTP requests). Updating curl via Homebrew also installs\/updates libcurl automatically; you don’t need a separate step unless you’re linking against it directly in a custom build, in which case brew info curl will show you the library paths.<\/p>\n

Updating curl for Development Use (Node.js, PHP, Python)<\/strong><\/h3>\n

If you’re updating curl because a language runtime or package manager depends on it (common with Node.js, PHP, or Python projects using libcurl bindings), make sure your project’s environment variables also point to the new path. For example, if you’re compiling a tool that links against libcurl, set:<\/p>\n

export LDFLAGS=”-L\/opt\/homebrew\/opt\/curl\/lib”<\/span>
\nexport CPPFLAGS=”-I\/opt\/homebrew\/opt\/curl\/include”<\/span><\/p><\/blockquote>\n

This ensures your build tools use the updated library rather than the older system version.<\/p>\n

FAQ<\/strong><\/h4>\n
    \n
  1. Do I need to update curl on macOS?
    \n<\/strong>Only if you’re hitting errors related to TLS versions, HTTP\/2, or missing features in newer curl releases. For everyday use, the pre-installed version works fine.<\/li>\n
  2. Will updating curl break anything on my Mac?
    \n<\/strong>No, as long as you install the new version through Homebrew or MacPorts rather than replacing the system binary. Both methods install alongside the original safely.<\/li>\n
  3. How do I check which curl version I’m using?
    \n<\/strong>Run curl –version. If it points to \/usr\/bin\/curl, you’re using Apple’s built-in version; if it points to \/opt\/homebrew\/bin\/curl or similar, you’re using your updated version.<\/li>\n
  4. How do I switch back to the system curl?
    \n<\/strong>Run brew unlink curl, or simply remove the Homebrew path from your PATH variable.<\/li>\n<\/ol>\n

     <\/p>\n

    On a different OS? Check out our cURL installation guide for Windows and Linux<\/em><\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"

    The fastest way to update curl on macOS is via Homebrew: run brew install curl, then brew link curl –force. This installs the latest curl version alongside the older system version that ships with macOS, without touching system files. macOS comes with curl pre-installed, but Apple often ships an older build with limited TLS\/SSL support. […]<\/p>\n","protected":false},"author":5,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[666],"tags":[1488],"class_list":["post-12811","post","type-post","status-publish","format-standard","hentry","category-general","tag-install-curl-on-macosx"],"yoast_head":"\nA Step-by-Step Guide: How to Install cURL on MacOSX<\/title>\n<meta name=\"description\" content=\"In this tutorial, we will guide you through the process of how to install cURL on macOS.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.bodhost.com\/kb\/a-step-by-step-guide-how-to-install-curl-on-macosx\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"A Step-by-Step Guide: How to Install cURL on MacOSX\" \/>\n<meta property=\"og:description\" content=\"In this tutorial, we will guide you through the process of how to install cURL on macOS.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.bodhost.com\/kb\/a-step-by-step-guide-how-to-install-curl-on-macosx\/\" \/>\n<meta property=\"og:site_name\" content=\"Knowledge Base - bodHOST\" \/>\n<meta property=\"article:published_time\" content=\"2026-06-29T05:18:43+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-06-29T13:40:39+00:00\" \/>\n<meta name=\"author\" content=\"Paul Lopez\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Paul Lopez\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/a-step-by-step-guide-how-to-install-curl-on-macosx\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/a-step-by-step-guide-how-to-install-curl-on-macosx\\\/\"},\"author\":{\"name\":\"Paul Lopez\",\"@id\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/#\\\/schema\\\/person\\\/566ccff9a2fae4af852be8097b179813\"},\"headline\":\"How to Update curl on macOS (Step-by-Step Guide)\",\"datePublished\":\"2026-06-29T05:18:43+00:00\",\"dateModified\":\"2026-06-29T13:40:39+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/a-step-by-step-guide-how-to-install-curl-on-macosx\\\/\"},\"wordCount\":698,\"publisher\":{\"@id\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/#organization\"},\"keywords\":[\"Install cURL on MacOSX\"],\"articleSection\":[\"General Discussion\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/a-step-by-step-guide-how-to-install-curl-on-macosx\\\/\",\"url\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/a-step-by-step-guide-how-to-install-curl-on-macosx\\\/\",\"name\":\"A Step-by-Step Guide: How to Install cURL on MacOSX\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/#website\"},\"datePublished\":\"2026-06-29T05:18:43+00:00\",\"dateModified\":\"2026-06-29T13:40:39+00:00\",\"description\":\"In this tutorial, we will guide you through the process of how to install cURL on macOS.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/a-step-by-step-guide-how-to-install-curl-on-macosx\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/a-step-by-step-guide-how-to-install-curl-on-macosx\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/a-step-by-step-guide-how-to-install-curl-on-macosx\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"General Discussion\",\"item\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/category\\\/general\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How to Update curl on macOS (Step-by-Step Guide)\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/#website\",\"url\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/\",\"name\":\"Web Hosting Knowledge Base | bodHOST Hosting FAQ\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/#organization\"},\"alternateName\":\"Web Hosting Knowledge Base | bodHOST Hosting FAQ\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/#organization\",\"name\":\"Web Hosting Knowledge Base | bodHOST Hosting FAQ\",\"url\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/wp-content\\\/uploads\\\/2025\\\/10\\\/Profile-Pic.png\",\"contentUrl\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/wp-content\\\/uploads\\\/2025\\\/10\\\/Profile-Pic.png\",\"width\":240,\"height\":240,\"caption\":\"Web Hosting Knowledge Base | bodHOST Hosting FAQ\"},\"image\":{\"@id\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/#\\\/schema\\\/logo\\\/image\\\/\"}},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/#\\\/schema\\\/person\\\/566ccff9a2fae4af852be8097b179813\",\"name\":\"Paul Lopez\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/c63d9f5400cd5ef87b481a24b2c1a4fb89f1674b6391325326cf13f1e735dff8?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/c63d9f5400cd5ef87b481a24b2c1a4fb89f1674b6391325326cf13f1e735dff8?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/c63d9f5400cd5ef87b481a24b2c1a4fb89f1674b6391325326cf13f1e735dff8?s=96&d=mm&r=g\",\"caption\":\"Paul Lopez\"},\"url\":\"https:\\\/\\\/www.bodhost.com\\\/kb\\\/author\\\/paullopez\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"A Step-by-Step Guide: How to Install cURL on MacOSX","description":"In this tutorial, we will guide you through the process of how to install cURL on macOS.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.bodhost.com\/kb\/a-step-by-step-guide-how-to-install-curl-on-macosx\/","og_locale":"en_US","og_type":"article","og_title":"A Step-by-Step Guide: How to Install cURL on MacOSX","og_description":"In this tutorial, we will guide you through the process of how to install cURL on macOS.","og_url":"https:\/\/www.bodhost.com\/kb\/a-step-by-step-guide-how-to-install-curl-on-macosx\/","og_site_name":"Knowledge Base - bodHOST","article_published_time":"2026-06-29T05:18:43+00:00","article_modified_time":"2026-06-29T13:40:39+00:00","author":"Paul Lopez","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Paul Lopez","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.bodhost.com\/kb\/a-step-by-step-guide-how-to-install-curl-on-macosx\/#article","isPartOf":{"@id":"https:\/\/www.bodhost.com\/kb\/a-step-by-step-guide-how-to-install-curl-on-macosx\/"},"author":{"name":"Paul Lopez","@id":"https:\/\/www.bodhost.com\/kb\/#\/schema\/person\/566ccff9a2fae4af852be8097b179813"},"headline":"How to Update curl on macOS (Step-by-Step Guide)","datePublished":"2026-06-29T05:18:43+00:00","dateModified":"2026-06-29T13:40:39+00:00","mainEntityOfPage":{"@id":"https:\/\/www.bodhost.com\/kb\/a-step-by-step-guide-how-to-install-curl-on-macosx\/"},"wordCount":698,"publisher":{"@id":"https:\/\/www.bodhost.com\/kb\/#organization"},"keywords":["Install cURL on MacOSX"],"articleSection":["General Discussion"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/www.bodhost.com\/kb\/a-step-by-step-guide-how-to-install-curl-on-macosx\/","url":"https:\/\/www.bodhost.com\/kb\/a-step-by-step-guide-how-to-install-curl-on-macosx\/","name":"A Step-by-Step Guide: How to Install cURL on MacOSX","isPartOf":{"@id":"https:\/\/www.bodhost.com\/kb\/#website"},"datePublished":"2026-06-29T05:18:43+00:00","dateModified":"2026-06-29T13:40:39+00:00","description":"In this tutorial, we will guide you through the process of how to install cURL on macOS.","breadcrumb":{"@id":"https:\/\/www.bodhost.com\/kb\/a-step-by-step-guide-how-to-install-curl-on-macosx\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.bodhost.com\/kb\/a-step-by-step-guide-how-to-install-curl-on-macosx\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.bodhost.com\/kb\/a-step-by-step-guide-how-to-install-curl-on-macosx\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"General Discussion","item":"https:\/\/www.bodhost.com\/kb\/category\/general\/"},{"@type":"ListItem","position":2,"name":"How to Update curl on macOS (Step-by-Step Guide)"}]},{"@type":"WebSite","@id":"https:\/\/www.bodhost.com\/kb\/#website","url":"https:\/\/www.bodhost.com\/kb\/","name":"Web Hosting Knowledge Base | bodHOST Hosting FAQ","description":"","publisher":{"@id":"https:\/\/www.bodhost.com\/kb\/#organization"},"alternateName":"Web Hosting Knowledge Base | bodHOST Hosting FAQ","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.bodhost.com\/kb\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.bodhost.com\/kb\/#organization","name":"Web Hosting Knowledge Base | bodHOST Hosting FAQ","url":"https:\/\/www.bodhost.com\/kb\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.bodhost.com\/kb\/#\/schema\/logo\/image\/","url":"https:\/\/www.bodhost.com\/kb\/wp-content\/uploads\/2025\/10\/Profile-Pic.png","contentUrl":"https:\/\/www.bodhost.com\/kb\/wp-content\/uploads\/2025\/10\/Profile-Pic.png","width":240,"height":240,"caption":"Web Hosting Knowledge Base | bodHOST Hosting FAQ"},"image":{"@id":"https:\/\/www.bodhost.com\/kb\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/www.bodhost.com\/kb\/#\/schema\/person\/566ccff9a2fae4af852be8097b179813","name":"Paul Lopez","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/c63d9f5400cd5ef87b481a24b2c1a4fb89f1674b6391325326cf13f1e735dff8?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/c63d9f5400cd5ef87b481a24b2c1a4fb89f1674b6391325326cf13f1e735dff8?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/c63d9f5400cd5ef87b481a24b2c1a4fb89f1674b6391325326cf13f1e735dff8?s=96&d=mm&r=g","caption":"Paul Lopez"},"url":"https:\/\/www.bodhost.com\/kb\/author\/paullopez\/"}]}},"_links":{"self":[{"href":"https:\/\/www.bodhost.com\/kb\/wp-json\/wp\/v2\/posts\/12811","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.bodhost.com\/kb\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.bodhost.com\/kb\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.bodhost.com\/kb\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/www.bodhost.com\/kb\/wp-json\/wp\/v2\/comments?post=12811"}],"version-history":[{"count":4,"href":"https:\/\/www.bodhost.com\/kb\/wp-json\/wp\/v2\/posts\/12811\/revisions"}],"predecessor-version":[{"id":15397,"href":"https:\/\/www.bodhost.com\/kb\/wp-json\/wp\/v2\/posts\/12811\/revisions\/15397"}],"wp:attachment":[{"href":"https:\/\/www.bodhost.com\/kb\/wp-json\/wp\/v2\/media?parent=12811"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.bodhost.com\/kb\/wp-json\/wp\/v2\/categories?post=12811"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.bodhost.com\/kb\/wp-json\/wp\/v2\/tags?post=12811"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}