+
+
+ + There is an ongoing outage on the primary CPAN mirror. It is + possible to work around the issue by using + MetaCPAN as a mirror. +
diff --git a/lib/MetaCPAN/Web/Controller/About.pm b/lib/MetaCPAN/Web/Controller/About.pm index fb06318690..37817d2d80 100644 --- a/lib/MetaCPAN/Web/Controller/About.pm +++ b/lib/MetaCPAN/Web/Controller/About.pm @@ -38,6 +38,8 @@ sub meta_hack : Local : Args(0) { my ( $self, $c ) = @_; } +sub mirror : Local : Args(0) { } + sub sponsors : Local : Args(0) { my ( $self, $c ) = @_; } diff --git a/root/about/mirror.tx b/root/about/mirror.tx new file mode 100644 index 0000000000..646490d820 --- /dev/null +++ b/root/about/mirror.tx @@ -0,0 +1,44 @@ +%% cascade base::about::markdown { +%% title => $title || 'Using MetaCPAN as a mirror', +%% } +%% override about -> { +## MetaCPAN Mirror + +MetaCPAN provides an alternate mirror for CPAN, which is also a BackPAN (it +includes deleted releases). It can be used if there are issues with the primary +mirror, or you want to access older deleted releases via the `cpan` client. + +The address for the mirror is https://cpan.metacpan.org/ + +### Configuring the Mirror + +#### `cpanm` + +`cpanm` can use the MetaCPAN mirror using the `-M` option: + + cpanm -M https://cpan.metacpan.org/ Module::To::Install + +When using the MetaCPAN mirror, it may also be useful to use MetaCPAN's index. +This can be done using the `--metacpan` option. + + cpanm -M https://cpan.metacpan.org/ --metacpan Module::To::Install + +These options can be set more permanantly using the `PERL_CPANM_OPT` environment variable. + + export PERL_CPANM_OPT='-M https://cpan.metacpan.org/ --metacpan' + cpanm Module::To::Install + +#### `cpan` + +`CPAN.pm` can be configured to use an alternate mirror using the `urllist` +configuration setting. It also must be configured to use the `urllist` option +by disabling the `pushy_https` option. + + cpan + o conf urllist https://cpan.metacpan.org/ + o conf pushy_https 0 + o conf commit + install Module::To::Install + exit + +%% } diff --git a/root/base.tx b/root/base.tx index a60a66599c..d7f1f69a25 100644 --- a/root/base.tx +++ b/root/base.tx @@ -22,7 +22,6 @@ - %% block opengraph -> { } @@ -118,7 +117,13 @@