CPAN

NORA acts as a caching proxy for CPAN. Distribution tarballs are cached immutably; the package index files use TTL-based refresh. This is a proxy-only registry — uploading distributions through NORA is not supported.

Client Configuration

Point cpanm at NORA:

cpanm --from http://nora.example.com:4000/cpan Module::Name

--from makes NORA the only mirror, so module lookups and downloads both go through it.

Upstream Proxy

config.toml:

[cpan]
enabled = true
proxy = "https://www.cpan.org"
proxy_timeout = 30
metadata_ttl = 300  # seconds
serve_stale = true

Environment variables:

Variable	Description	Default
`NORA_CPAN_ENABLED`	Enable the CPAN proxy	`false`
`NORA_CPAN_PROXY`	Upstream CPAN mirror URL	`https://www.cpan.org`
`NORA_CPAN_PROXY_AUTH`	Upstream auth (`user:pass`)	—
`NORA_CPAN_PROXY_TIMEOUT`	Upstream timeout in seconds	`30`
`NORA_CPAN_METADATA_TTL`	Index cache TTL in seconds	`300`
`NORA_CPAN_SERVE_STALE`	Serve a stale cached copy when the upstream is unreachable	`true`

Features

Feature	Status	Notes
Package index (`modules/02packages.details.txt.gz`)	Full	TTL-cached
Module list (`modules/03modlist.data.gz`)	Full	TTL-cached
Author directory (`authors/01mailrc.txt.gz`)	Full	TTL-cached
Distribution download (`authors/id/…`)	Full	Immutable cache
Stale cache on upstream failure	Full	`x-nora-stale: true`
Distribution upload	—	Proxy-only (read)

Known Limitations

Proxy-only: uploading distributions is not supported (PUT answers 405).
The web UI groups cached releases by their archive file names; a name it cannot parse is left out of the grouped author view.
Disabled by default. Set NORA_CPAN_ENABLED=true to activate.