2.3: Launching Pharo

Last updated
Save as PDF

Page ID: 39572

\( \newcommand{\vecs}[1]{\overset { \scriptstyle \rightharpoonup} {\mathbf{#1}} } \) \( \newcommand{\vecd}[1]{\overset{-\!-\!\rightharpoonup}{\vphantom{a}\smash {#1}}} \)\(\newcommand{\id}{\mathrm{id}}\) \( \newcommand{\Span}{\mathrm{span}}\) \( \newcommand{\kernel}{\mathrm{null}\,}\) \( \newcommand{\range}{\mathrm{range}\,}\) \( \newcommand{\RealPart}{\mathrm{Re}}\) \( \newcommand{\ImaginaryPart}{\mathrm{Im}}\) \( \newcommand{\Argument}{\mathrm{Arg}}\) \( \newcommand{\norm}[1]{\| #1 \|}\) \( \newcommand{\inner}[2]{\langle #1, #2 \rangle}\) \( \newcommand{\Span}{\mathrm{span}}\) \(\newcommand{\id}{\mathrm{id}}\) \( \newcommand{\Span}{\mathrm{span}}\) \( \newcommand{\kernel}{\mathrm{null}\,}\) \( \newcommand{\range}{\mathrm{range}\,}\) \( \newcommand{\RealPart}{\mathrm{Re}}\) \( \newcommand{\ImaginaryPart}{\mathrm{Im}}\) \( \newcommand{\Argument}{\mathrm{Arg}}\) \( \newcommand{\norm}[1]{\| #1 \|}\) \( \newcommand{\inner}[2]{\langle #1, #2 \rangle}\) \( \newcommand{\Span}{\mathrm{span}}\)\(\newcommand{\AA}{\unicode[.8,0]{x212B}}\)

To start Pharo, do whatever your operating system expects: drag the .image file onto the icon of the virtual machine, or double-click the .image file, or at the command line type the name of the virtual machine followed by the path to the .image file.

On OS X, double click the Pharo5.0.app bundle in the unzipped download.

On Linux, double click (or invoke from the command line) the pharo executable bash script from the unzipped Pharo folder.

On Windows, enter the unzipped Pharo folder and double click Pharo.exe.

In general, Pharo tries to ”do the right thing”. If you double click on the VM, it looks for an image file in the default location. If you double click on an .image file, it tries to find the nearest VM to launch it with.

If you have multiple VMs installed on your machine, the operating system may no longer be able to guess the right one. In this case, it is safer to specify exactly which ones you meant to launch, either by dragging and dropping the image file onto the VM, or specifying the image on the command line (see the next section).

Launching Pharo via the command line

The general pattern for launching Pharo from a terminal is:

<Pharo executable> <path to Pharo image>

Linux command line. For Linux, assuming that you’re in the unzipped pharo5.0 folder:

./pharo shared/Pharo5.0.image

OS X command line. For OS X, assuming that you’re in the directory with the unzipped Pharo5.0.app bundle:

Pharo5.0.app/Contents/MacOS/Pharo
    Pharo5.0.app/Contents/Resources/Pharo5.0.image

When using a Pharo bundle, you need to right-click on Pharo5.0.app and select ’Show Package Contents’ to get access to the image. If you need this often, just download a separated image/changes pair and drop that image into the Pharo5.0.app.

Windows command line. For Windows, assuming that you’re in the unzipped Pharo5.0 folder:

Pharo.exe Pharo5.0.image