CPAN-MIRRORS(1)

🦋 CPAN-MIRRORS 💅

okay so bestie, this is the manpage for cpan-mirrors — it lives in the User Contributed Perl Documentation section of the manual (section 1, the "you can literally just run this" section, iykyk). It's about finding the fastest CPAN mirrors near you. and when I say fast I mean fast. ✨

---

✨ NAME ✨

cpan-mirrors — Find the fatest CPAN mirrors nearby 🏃♀️💨

not me pointing out that "fatest" is the actual spelling in the original and I am NOT fixing it because the rule is the rule, bestie 💀

---

🎀 SYNOPSIS 🎀

just run it. that's the whole vibe:

        % cpan-mirrors

        Testing Africa
                is.co.za -> 733.72 ms
                wa.co.za -> 601.56 ms
                ucu.ac.ug -> 407.99 ms
                mirror.ac.za -> 614.05 ms
                zol.co.zw -> 612.57 ms
                -->median time: 612.57 ms
        Testing Oceania
                serversaustralia.com.au -> 38.62 ms
                cpan.inspire.net.nz -> 67.81 ms
                digitalpacific.com.au -> 37.89 ms
                uber.com.au -> 44.47 ms
                lagoon.nc -> 67.49 ms
                -->median time: 44.47 ms
        Testing North America
                httpupdate40.cpanel.net -> 254.00 ms
                httpupdate35.cpanel.net -> 409.75 ms
                mirrors.sonic.net -> 368.56 ms
                httpupdate8.cpanel.net -> 409.10 ms
                cpan.cs.utah.edu -> 408.00 ms
                -->median time: 408.00 ms
        Testing Asia
                vinahost.vn -> 146.10 ms
                yazd.ac.ir -> 469.29 ms
                mirrors-ru.go-parts.com -> 367.09 ms
                sohu.com -> 399.76 ms
                neolabs.kz -> 610.92 ms
                -->median time: 399.76 ms
        Testing South America
                mmgdesigns.com.ar -> 407.96 ms
                nbtelecom.com.br -> 401.96 ms
                sunsite.dcc.uchile.cl -> 415.69 ms
                linorg.usp.br -> 424.65 ms
                unal.edu.co -> 407.60 ms
                -->median time: 407.96 ms
        Testing Europe
                uk2.net -> 409.37 ms
                ambiweb.de -> 710.65 ms
                bibleonline.ru -> 471.49 ms
                rol.ru -> 469.70 ms
                rub.de -> 346.57 ms
                -->median time: 469.70 ms
        Median result by continent:
                44 ms  Oceania
           400 ms  Asia
           408 ms  South America
           408 ms  North America
           470 ms  Europe
           613 ms  Africa
        Best continent is Oceania
        cpan.catalyst.net.nz = 78.8369178771973 ms
        cpan.inspire.net.nz = 69.4258213043213 ms
        cpan.mirrors.ilisys.com.au = 50.2209663391113 ms
        digitalpacific.com.au = 40.1251316070557 ms
        lagoon.nc = 88.8760089874268 ms
        nautile.nc = 65.7081604003906 ms
        optusnet.com.au = 41.4729118347168 ms
        serversaustralia.com.au = 46.1521148681641 ms
        uber.com.au = 48.2730865478516 ms
        waia.asn.au = 86.2929821014404 ms
        webtastix.net = 70.5790519714355 ms
        Best mirrors are digitalpacific.com.au
                optusnet.com.au
                serversaustralia.com.au
                uber.com.au
                cpan.mirrors.ilisys.com.au

        Best urls are
                http://cpan.mirror.digitalpacific.com.au/
                http://mirror.optusnet.com.au/CPAN/
                http://cpan.mirror.serversaustralia.com.au/
                http://cpan.mirror.uber.com.au/
                http://cpan.mirrors.ilisys.com.au/

like. it tests a bunch of continents, medians them, picks a winner, and hands you the URLs. Oceania ate that whole run fr fr 🌊

---

💖 DESCRIPTION 💖

CPAN Mirrors come and go, and maybe you do too. (the manpage said it, not me!!) The mirror that was fast then might not be fast now — especially if you changed hemispheres. ma'am you moved to the other side of the planet, your 40ms mirror is now a 700ms jump scare 😭

This program goes through the MIRRORED.BY file and pings a selection of mirrors on each continent to find the fastest mirrors. From the best continent, it samples several mirrors to find the URL you should add to your configuration. it's giving "personal shopper but for latency" 🛍️✨

If you don't have a MIRRORED.BY file, this program will download one for you. It looks through your existing "urllist" configuration and then default locations. It stores it in ~/.cpan (or your configured location to store files). so basically it will not let you be fileless and helpless, she's got you 🫶

---

🌈 TO DO 🌈

stuff that isn't done yet, bestie, don't come for her:

• Add an option to update the CPAN configuration
• Add an option to give JSON output

both iconic ideas ngl, the JSON one would slay so hard for scripting

---

👑 AUTHOR 👑

brian d foy "<bdfoy@cpan.org>" 💜

---

📜 LICENSE 📜

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See <http://www.perl.com/perl/misc/Artistic.html>

---

okay that's the whole page, you're fully caught up 💅

and for the cute sign-off: this was written for perl v5.42.0, dated 2025-07-25 — so yes, it's fresh, it's current, it's the version you're looking at right now. go find yourself a fast mirror, bestie, you deserve low ping and high vibes 🌸🦋✨