What Is a cURL Command and How to Use It
The cURL command is a useful Linux tool for data transfer and connection troubleshooting. At the client side, cURL is powered by libcurl, a free URL transfer library.
Let’s go deeper and figure out how to use it.
What Is cURL Command?
cURL (Client URL) is a command-line tool, which allows to transfer data to or from a server without user interaction using supported libcurl library. cURL can also be used to troubleshoot connection issues.
How to Check cURL Version
Just like with any Linux command, before we begin working with cURL, we need to log into our VPS. If you need help, check out this tutorial about SSH.
First, let’s check what version of cURL is available with the following command:
curl --version
The output will show the cURL version a list of supported protocols. Now we can look at some cURL command examples
Basic cURL Command Syntax
Let’s learn how to use cURL commands. The basic syntax of cURL looks like this:
curl [OPTIONS] [URL]
The simplest use of cURL is to display the contents of a page. The below example will render the home web page of testdomain.com.
curl testdomain.com
This will render the complete source code of the homepage for the domain. If no protocol is specified curl will interpret this to HTTP.
cURL Command File Options
cURL commands can download files from a remote location. You can do it in two different ways:
- -O will save the file in the current working directory with the same file name as remote.
- -o lets you specify a different file name or location
An example of this is as shown below:
curl -O http://testdomain.com/testfile.tar.gz
The above command will save this as testfile.tar.gz.
curl -o newtestfile.tar.gz http://testdomain.com/testfile.tar.gz
The above command will save this as newtestfile.tar.gz.
If for some reason, the download gets interrupted, you can resume it using cURL. You can do this with the following command:
curl -C - -O http://testdomain.com/testfile.tar.gz
Using cURL, we can also download multiple files, like shown below:
curl -O http://testdomain.com/testfile.tar.gz -O http://mydomain.com/myfile.tar.gz
If you want to download multiple files from multiple URL, list all of them in a file. cURL commands can be combined with xargs to download the different URLs.
For instance, if we have a file allUrls.txt which contains a list of all URLs to be downloaded, then the below example can be used to download all files.
xargs –n 1 curl -O < allUrls.txt
How to Use Linux cURL Command
Now that you understand the fundamentals of the cURL command let’s go deeper and look at some practical uses.
How to Use cURL Commands for HTTP
cURL can also be used when there is a proxy server. If you are behind a proxy server listening on port 8090 at sampleproxy.com, download the files as shown below:
curl -x sampleproxy.com:8090 -U username:password -O http:// testdomain.com/testfile.tar.gz
In the above example, you can skip -U username:password if the proxy does not require an authentication method.
A typical HTTP request will always contain a header. The HTTP header sends additional information about the remote web server along with the actual request. While through a browser’s developer tools you can check the header information, you can verify it using a cURL command.
Below is an example of how to retrieve header information from a website.
curl -I www.testdomain.com
Using cURL, you can make a GET and a POST request. A GET request will be as follows:
curl http://mydomain.com
A sample of a POST request will be as shown below:
curl –data “text=Hello” https://myDomain.com/firstPage.jsp
Over here text=Hello is the POST request parameter. This behavior would be similar to HTML forms.
You can also specify multiple HTTP methods in a single cURL command. Do this by using –next option, like this:
curl –data “text=Hello” https://myDomain.com/firstPage.jsp --next https://myDomain.com/displayResult.jsp
This contains a POST request followed by a GET request.
Every HTTP request will have a user agent which is sent as part of the request. This indicates the web browser details of the client. By default, a cURL request contains curl and the version number as the user agent details. A sample output is as shown below:
“GET / HTTP/1.1” 200 “_” ”curl/7/29/0”
You can change this default user agent information using the below command:
curl -I http://mydomain.com –-user-agent “My new Browser”
Now the changed output will be:
“GET / HTTP/1.1” 200 “_” ”My new Browser”
How to Use cURL for Cookies
cURL commands can be used to check what cookies get downloaded on any URL. So, if you are accessing https://www.samplewebsite.com, then you can output to a file, save the cookies and access them using cat or a VIM editor.
Below is a sample of such command:
curl --cookie-jar Mycookies.txt https://www.samplewebsite.com /index.html -O
Similarly, if you have the cookies in a file, then you can send it to the website. An example of such command is as shown below:
curl --cookie Mycookies.txt https://www. samplewebsite.com
How to Use cURL for FTP
cURL command supports FTP! You can use them to download files from a remote server.
curl -u username:password -O ftp://sampleftpserver/testfile.tar.gz
In the above command, ftp://sampleftpserver is an FTP server which accepts connections. The username and password can be skipped for anonymous FTP connections. Type in the command and watch the progress bar fill up.
You can upload files as well with the command below:
curl -u username:password -T testfile.tar.gz ftp://sampleftpserver
Again, we can skip the username and password for anonymous FTP connections.
How to Limit cURL Output
While using a cURL you can’t know how big the output will be. You can restrict bandwidth, to make sure it’s not throttled by cURL.
The below command restricts the bandwidth to 100K:
curl --limit-rate 100K http://testdomain.com/samplefile.tar.gz -O
Conclusion
cURL is a powerful and widely used command. It’s useful when you’re dependent on the command line. It has several options and supports multiple protocols. That’s a pretty great reason to learn this command!
Remember, if you want to learn some advanced commands, refer to the manual that should be in all Unix versions:
man curl
We hope this tutorial gave you a good jumping off point for using cURL! How will you use this command? Let us know in the comments!
Discover Other Linux Commands for Server Management
How to Check Disk Space on Linux
How to Calculate Process Execution With Time Command
How to Read a File With Sed Command
How to Transfer Files Using Scp Command
How to Monitor Changes With Watch Command
How to Shutdown and Restart the Server
How to Transfer and Synchronize Data With Rsync
How to Manage and List Services in Linux
How to Use the Linux Grep Command
Comments
September 11 2021
I like using: curl ifconfig.co when I manage to ssh into a remote network device and need to know the public IP address of the network.