Downloads

The recommended way to use Rakudo is by downloading Rakudo Star – a useful and usable production distribution of Perl 6. Rakudo Star includes both the Rakudo compiler and some commonly used libraries.
You can also download from the list of older releases. Below are full details for all your other options!

Detailed Instructions

Definitions

Some grossly over-simplified definitions:

  • Perl 6 is a language specification.
  • Rakudo is a compiler for Perl 6.
  • Rakudo Star (or Rakudo *) is a distribution that contains the Rakudo compiler, documentation and some useful modules.
  • MoarVM and JVM are Process Virtual Machines. They provide an interface between the compiler and the underlying operating system or machine. MoarVM generally offers more support and is a preferred choice.

Installing Rakudo Star

Rakudo Star is the recommended way to obtain Perl 6 for most users.
It comes with several modules, but none of them are essential. If you already installed the Rakudo compiler,
you can simply browse the modules ecosystem and install only the modules you plan to use.

Windows

Windows Installer packages are available as MSI files here:

https://rakudo.perl6.org/downloads/star/

As of the 2015.02 version, the MSI installs Rakudo Star with MoarVM under C:\rakudo\. The executable files can be found under C:\rakudo\bin\, and a shortcut will be placed under your menu.

If you want to use the Linux Subsystem of Windows 10, see below in the section about nxadm’s rakudo-pkg repository

OS X

Rakudo Star is available from Homebrew, and Rakudo from MacPorts. If you want to check the version before installing:

brew info rakudo-star

To install:

brew install rakudo-star

And on MacPorts (Rakudo only):

sudo port install rakudo

Linux & Unix-like operating systems

It’s possible your distribution already includes a rakudo package, however, ensure the available version is a recent one. Rakudo compiler gets released every month and Rakudo Star distribution every three months. The versioning is based on release dates, e.g. version 2017.07.

Up-to-date packages for CentOS, Debian, Fedora and Ubuntu can be found at the releases section of nxadm’s “rakudo-pkg” repository on github. Following the instructions on the page, you’ll install the Rakudo compiler and zef module installer. You can then use zef to install any of the Rakudo Star or ecosystem modules you might wish to use. If you use the Linux Subsystem of Windows 10, you can install nxadm’s Ubuntu 16.04 package (run /opt/rakudo/bin/fix_windows10 after the install).

Another alternative, is to install Rakudo Star from source code.

Cygwin

Because of a not yet implemented POSIX interface in cygwin (specifically pthread_barrier needed by libuv), Rakudo can not yet be compiled on that environment. You can use the regular Windows build, however. Just use /cygdrive/c/rakudo/bin/perl6.bat as the perl6 executable.

Building from source

The recommended way to obtain rakudo is via packaged releases described above. If you issues with that method, you can build rakudo from source.

Prerequisites

To install Rakudo Star from source you’ll need Perl 5.10 or newer, git, make and gcc. Many distributions provide package groups that install common build tools. Here are examples for some popular Linux distributions:

Debian / Ubuntu
apt-get install build-essential git libssl-dev
Red Hat / CentOS / Fedora
yum install git
yum groupinstall 'Development Tools'

Fedora: perl-ExtUtils-Command must be installed as well:

yum install perl-ExtUtils-Command

CentOS 7 (and perhaps other versions too), Perl 5 autodie must be installed too:

yum install perl-autodie

Installation

The exact steps required may differ depending on your operating system. This example uses Rakudo Star 2017.07; ensure you’re installing the latest available version. You should consult the README file contained in the tarball for more up-to-date and detailed information.

mkdir ~/rakudo && cd $_
curl -O https://rakudo.perl6.org/downloads/star/rakudo-star-2017.07.tar.gz
tar -xvzf rakudo-star-2017.07.tar.gz
cd rakudo-star-2017.07/

perl Configure.pl --backend=moar --gen-moar
make

# If you wish, you can run the tests
# Depending on your machine, they could take over half an hour to run
make rakudo-test
make rakudo-spectest

make install

echo "export PATH=$(pwd)/install/bin/:$(pwd)/install/share/perl6/site/bin:\$PATH" >> ~/.bashrc
source ~/.bashrc

Using Rakudo

To run a Perl 6 program with Rakudo, include the install directory in your system PATH variable and issue a command like:

perl6 hello.pl

If the Rakudo compiler is invoked without an explicit script to run, it enters a small interactive mode that allows Perl 6 statements to be executed from the command line. Each line entered is treated as a separate compilation unit, which means that subroutines are preserved after they are defined, but variables are not.

Discouraged Tools

At some point in the past, the following tools were in wide use and recommended. Their use now is discouraged.

rakudobrew

Rakudobrew was originally designed for core developers to run multiple versions of Rakudo at the same time. Upon its utilization by many regular users, we found common reports of issues that were caused by rakudobrew itself, rather than problems in Rakudo. Its default instructions also build the latest, minimally-tested Rakudo commit, rather than a well-tested release, and rakudobrew also requires running `rakudobrew rehash` after installing any binaries.

Rakudobrew is still available from its GitHub repository, however, its use is discouraged. Regular users should install Rakudo Star. Users who wish to build latest, minimally-tested Rakudo commits should simply build rakudo from a GitHub checkout, without using rakudobrew.

panda

Panda used to be the primary module installer. Now zef is the installer of choice. It is more actively maintained and offers more features (among others, features like installation of modules from CPAN).

Panda is still available from its GitHub repository, but it’s deprecated and may be broken on newer versions of Rakudo.