---
name: "CPANPLUS::Shell::Default::Plugins::CustomSource"
section: "3pm"
platform: "linux"
package: "perl-cpanplus"
version: "0.9916-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/CPANPLUS::Shell::Default::Plugins::CustomSource/3pm"
---

# CPANPLUS::Shell::Default::Plugins::CustomSource(3pm)

add custom sources to CPANPLUS

## NAME

CPANPLUS::Shell::Default::Plugins::CustomSource - add custom sources to CPANPLUS

## SYNOPSIS

```
    ### elaborate help text
    CPAN Terminal> /? cs
    ### add a new custom source
    CPAN Terminal> /cs --add file:///path/to/releases
    ### list all your custom sources by
    CPAN Terminal> /cs --list
    ### display the contents of a custom source by URI or ID
    CPAN Terminal> /cs --contents file:///path/to/releases
    CPAN Terminal> /cs --contents 1
    ### Update a custom source by URI or ID
    CPAN Terminal> /cs --update file:///path/to/releases
    CPAN Terminal> /cs --update 1
    ### Remove a custom source by URI or ID
    CPAN Terminal> /cs --remove file:///path/to/releases
    CPAN Terminal> /cs --remove 1
    ### Write an index file for a custom source, to share
    ### with 3rd parties or remote users
    CPAN Terminal> /cs --write file:///path/to/releases
    ### Make sure to save your sources when adding/removing
    ### sources, so your changes are reflected in the cache:
    CPAN Terminal> x
```

## DESCRIPTION

This is a `"CPANPLUS::Shell::Default"` plugin that can add custom sources to your CPANPLUS installation. This is a wrapper around the `"custom module sources"` code as outlined in "CUSTOM MODULE SOURCES" in CPANPLUS::Backend.

This allows you to extend your index of available modules beyond what's available on `"CPAN"` with your own local distributions, or ones offered by third parties.