- Installing Rakudo Star
- Using Rakudo
- Discouraged Tools
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 Installer packages are available as MSI files here:
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
Rakudo Star is available from Homebrew, and Rakudo from MacPorts. If you want to check the version before installing:
brew info rakudo-star
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.
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.
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.
To install Rakudo Star from source you’ll need Perl 5.10 or newer,
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
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
To run a Perl 6 program with Rakudo, include the install directory in your system PATH variable and issue a command like:
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.
At some point in the past, the following tools were in wide use and recommended. Their use now is discouraged.
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 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.