The perlbrew for Windows Strawberry Perl!

For a quick-start, jump to the Install and Commands sections.

berrybrew can download, install, remove and manage multiple concurrent versions of Strawberry Perl for Windows. There is no requirement to have Strawberry Perl installed before using berrybrew.

Use the bb command as a short hand name for berrybrew.

There is extensive documentation available for the berrybrew application, as well as the Berrybrew API.

See Other Documentation for the full list of documentation.

• Install
• Uninstall
• Configuration
• Commands
• Examples
• Update Perls Available
• Configure Perl Instance Directory
• Requirements
• Troubleshooting
• Development, Build, Test and Release
• Documentation
• Hidden Commands
• Developed Using
• Caveats
• License
• Version

The easiest and most straight forward method.

berrybrewInstaller.exe SHA1: 5917766c003525f736a5cf409e1c4d0fd4cb345f

git clone https://github.com/stevieb9/berrybrew cd berrybrew bin\berrybrew.exe config 

berrybrew.zip SHA1: fdf4cf104cff8d6513d0511f383c034d203c1022

After extraction:

cd berrybrew bin\berrybrew.exe config 

You can also Compile your own installation.

If you used the self-extracting installer, simply run the uninstaller from either Add/Remove Programs in the Control Panel, or the uninst.exe uninstaller program located in the installation directory.

If you installed via any other method:

First, run the berrybrew associate unset if you're managing the .pl file association with berrybrew.

Then, run the berrybrew unconfig command which removes the PATH environment variables for any in-use Perl installation, and then removes berrybrew from the PATH as well.

If you wish to delete the actual installation:

• Stop the UI if it's running (right-click the System Tray Icon, and click Exit)

• Remove the Perl installation root directory (by default C:\berrybrew)

• Remove the original download directory

• Remove the Computer\HKEY_LOCAL_MACHINE\SOFTWARE\berrybrew registry key

• If you've installed the UI, remove the Computer\HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\Current Version\Run\BerrybrewUI registry value

See the Configuration document, and the options command in the berrybrew documentation.

Several of the modifiable options are configurable through the UI.

See the berrybrew documentation for a full explanation of all of the following commands.

For all commands that require the name of a Perl (eg: install), we will default to 64-bit (ie. _64) if this suffix is omitted.

berrybrew <command> [subcommand] [option] associate * View and set Perl file association available * List available Strawberry Perl versions and which are installed list List installed Strawberry Perl versions clean * Remove all temporary berrybrew files clone Make a complete copy of a Perl installation config Add berrybrew to your PATH exec * Run a command for every installed Strawberry Perl fetch Update the list of Strawberry Perl instances available hidden Display the list of hidden/development commands install Download, extract and install a Strawberry Perl modules * Export and import a module list from one Perl to install on another options * Display or set a single option, or display all of them with values off Disable berrybrew perls (use 'switch' to re-enable) register Manually register a custom installation directory remove Uninstall a Strawberry Perl snapshot * Export and import snapshots of Perl instances switch * Switch to use a different Strawberry Perl unconfig Remove berrybrew from PATH use * Use a specific Strawberry Perl version temporarily virtual Allow berrybrew to manage an external Perl instance help Display this help screen license Show berrybrew license version Displays the version * - view subcommand details with 'berrybrew <command> help' 

See the berrybrew document for usage examples.

Using the installer is the best and safest way to upgrade your berrybrew. You can stop reading here if you use the installer to install berrybrew.

Doing a straight git pull will overwrite your configuration files, so back them up first (see Caveats).

Use the Fetch button in the UI, or, at the command line, use berrybrew fetch to retrieve the most recent availability list from Strawberry Perl. If any new or changed versions are found, we'll update the local perls.json file with them.

If using the installer to install from, you'll have the opportunity to configure this option during install, and nothing further is required.

Otherwise, follow these directions:

By default, we manage Perls out of the C:\berrybrew directory. To change this, modify the root_dir value in the data\config.json file. Use double-backslashes (\\) as the path separators.

WARNING: At this time, it is highly advised not to change this after you've already installed any instances of Perl. This feature is incomplete, and PATH and other things don't get properly reset yet. If you choose to ignore this, follow this procedure:

• create a new directory in the file system to house the Perl instances

• run berrybrew options root_dir PATH, where PATH is the full path to the directory you'd like to store Perls in

• run berrybrew options temp_dir PATH, where PATH is the full path to the temporary storage area. Typically, this is a directory inside of the root_dir you set above

• run berrybrew off, to flush the PATH environment variables

• move all Perl installations from the old path to the new one

• remove the old directory

• run berrybrew switch $version to set things back up

• .Net Framework 2.0 or higher

• Windows only!

• Mono or Visual Studio (only if compiling your own version)

If you run into trouble installing a Perl, try clearing the berrybrew cached downloads by running berrybrew clean.

You can also enable debugging to get more verbose output on the command line:

berrybrew debug <command> [options] 

Contains all information relating to the development, build, test and release cycle of the berrybrew ecosystem.

See the Berrybrew Development, Build, Test and Release document.

• berrybrew Full documentation for the application

• Berrybrew API API documentation

• Configuration Guide to various configuration files and options

Please see the hidden commands in the berrybrew document.

You can also get a list of them by running the hidden berrybrew hidden command.

• When using git pull to do an upgrade, your configuration files will be overwritten with the defaults. If you have any customizations, make a backup of the data directory before upgrade, then copy the files back to their original location. Note that you may have to manually add any new config directives into the original config files. The perls_custom.json file used for custom Perl installations (clones) and the perls_virtual.json file used for virtual Perl installations will never be overwritten, and this warning does not apply for them.

• At this time, berrybrew requires Administrative privileges to operate correctly. This is due to the way Windows forces the System PATH to take precedence over User PATH.

2 Clause FreeBSD - see LICENSE.

David Farrell

Steve Bertrand steveb<>cpan.org

• StrawberryPerl - Strawberry Perl for Windows

• Perlbrew - the original Perl version manager for Unix based systems.

1.41