Installing cURL properly on OpenWRT Chaos Calmer (15.05.1) for ar71xx TP-LINK MR3020

To install cURL on OpenWRT Chaos Calmer (15.05.1) for the TP-LINK MR3020, you must update the package index and then use opkg to install the curl package. This process enables HTTP, HTTPS, FTP, and other protocol support on your router, allowing it to interact with external services, fetch data, or act as a client for remote APIs without needing additional hardware. The TP-LINK TL-MR3020 is an older ar71xx-based device, which means it relies on the legacy Chaos Calmer release series. While modern OpenWRT versions have streamlined their package repositories, version 15.05.1 requires specific attention to ensure that the package manager can locate the correct binary for your architecture. The standard procedure involves verifying connectivity, refreshing the local cache of available packages, and executing the installation command. If you encounter errors during this process, they are usually related to network configuration, repository URLs, or insufficient storage space on the router's flash memory.

Verifying Network Connectivity

Before attempting to install any new software, you must ensure that the router has an active internet connection. The opkg package manager downloads binaries from remote servers, so if the router cannot reach these servers, the installation will fail immediately. You should first check if the WAN interface is configured correctly and obtaining an IP address via DHCP or static assignment. You can test basic connectivity by pinging a reliable DNS server or website. Run the following command in the SSH terminal:

ping -c 4 8.8.8.8

If this command returns successful replies, your network stack is functioning. If it times out, check your physical connections, PPPoE settings, or firewall rules. Note that some users may have restricted access in their LuCI interface. For reference on managing network permissions, see Grant LuCI Internet Access to OpenWRT Router/Switch. Ensure that the firewall allows outbound traffic on ports 80 and 443, as these are required for downloading packages over HTTP and HTTPS respectively.

Updating the Package Index

OpenWRT uses the opkg utility to manage software. Before installing a new package, it is critical to update the local list of available packages. This list tells opkg where to find the latest versions of software compatible with your specific CPU architecture (ar71xx-generic in this case). Skipping this step often leads to errors where opkg claims a package does not exist, even though it is available in the repository. Execute the update command by running:

opkg update

This command contacts the configured feed servers listed in /etc/opkg/distfeeds.conf. It downloads the package lists into the local cache. Depending on your internet speed and the size of the repository, this may take a few seconds. If you receive an error such as "Failed to download" or "Server not found," verify that your distfeeds.conf file points to a valid mirror for the Chaos Calmer 15.05.1 release. Common mirrors include the official OpenWRT archive or regional mirrors like those hosted by university networks.

Installing cURL

Once the package index is updated, you can proceed with the actual installation. The package name in OpenWRT is simply curl. There are no extra dependencies that typically conflict with this installation on ar71xx devices, although curl may pull in libopenssl or librtmp if they are not already present. Run the installation command:

opkg install curl

The system will display the packages it intends to install along with their sizes. Confirm the operation if prompted. After the installation completes, verify that cURL is available by checking its version:

curl --version

This should output the version number and supported protocols. If the command is not found, ensure that the /usr/bin directory is included in your $PATH environment variable. In most standard OpenWRT installations, this is handled automatically.

Troubleshooting Installation Errors

Users frequently encounter issues when installing packages on older routers due to limited storage. The TP-LINK MR3020 has very little free space in its root filesystem. If you see an error stating "No space left on device," you may need to remove unnecessary packages or expand the partition using block mount commands. Another common issue is signature verification failures. If opkg rejects the package due to a bad signature, ensure that your system time is synchronized. An incorrect date can cause SSL certificate validation to fail. You can manually set the time using the date command or configure NTP to keep it accurate. Additionally, if you are using a custom firmware build or have modified the feeds configuration, you might be pointing to a repository that does not contain the curl package for your specific sub-architecture. In such cases, revert to the default feeds or consult the official Chaos Calmer documentation for the correct URL structure. For more context on running different OpenWRT versions, you might find Running OpenWRT 23.05 on Netgear C3000 (Comcast Modem/Router) useful for understanding general package management differences across releases.

Using cURL on Your Router

With cURL installed, you can perform various tasks such as fetching weather data, updating dynamic DNS records, or testing web service availability. For example, to check if a website is reachable, you can run:

curl -I http://example.com

This sends a HEAD request and displays the HTTP headers, including status codes. You can also use cURL to upload files or post data to APIs, making your router a versatile tool for automation scripts. Always ensure that scripts using cURL are stored securely, as they may contain sensitive credentials or API keys.

Frequently Asked Questions

Why does opkg say "Package curl not found"?

This error occurs when the local package index is outdated or the repository URL is incorrect. Running opkg update refreshes the list of available packages from the server. If the error persists, check your /etc/opkg/distfeeds.conf file to ensure it points to a valid Chaos Calmer mirror.

Can I install cURL without an internet connection?

No, opkg requires network access to download the binary packages from the remote repository. You must have a working WAN connection and DNS resolution before attempting the installation. If you lack internet, you would need to manually transfer the .ipk files via USB or SCP, which is complex on ar71xx devices.

Does cURL support HTTPS on OpenWRT Chaos Calmer?

Yes, the standard curl package includes support for HTTPS through libcurl. However, it relies on the system's CA certificates to verify server identities. Ensure that the ca-certificates package is installed if you plan to connect to secure sites, otherwise, SSL verification may fail.

How do I remove cURL after installation?

You can uninstall the package using the remove flag in opkg. Run opkg remove curl to delete the binary and its associated files. This frees up storage space on your router's flash memory, which is particularly important for devices with limited capacity like the MR3020.

Is there a lighter alternative to cURL for simple HTTP requests?

While wget is another common tool, it is often pre-installed on OpenWRT systems. If you only need basic GET requests, wget might suffice without adding extra dependencies. However, cURL offers more flexibility with headers, authentication methods, and multiple protocol support, making it superior for complex scripting tasks.