ToC | DocOverview | CGDoc | RelNotes | FAQ | Index | PermutedIndex
| Allegro CL version 10.1

# Allegro CL 10.1 Express Installation

## Introduction

Thank you for your interest in Allegro Common Lisp, Express edition. This is free software made available to introduce Allegro CL to students, hobbyists, and prospective customers. There is a heap limitation compared to the commercial versions of Allegro CL. If you run into issues running software you feel should work in Express, please contact us at `support@franz.com`.

This document describes installation of Allegro Common Lisp Express, the free version of Allegro Common Lisp. Installation of the commercial Allegro CL and related products is described in installation.htm.

Allegro CL comes with a development environment called the IDE (Integrated Development Environment), not available on FreeBSD. On all platforms except Windows the IDE now runs in a browser tab, and it is now the only option. (More information on this browser-based IDE and CG/JS is available here.)

Starting in February 2022, the installation of Express was greatly simplified.

To run the browser-based IDE, no additional software is required on Windows and macOS. On the various Linux systems, OpenSSL is required but that is most certainly installed with the browser, which is required to use the IDE. (For details see Secure Socket Layer (SSL) in socket.htm).

The GTK windowing system, previously required for the IDE, is no longer required on any platform.

On Windows only, Allegro CL Express defaults to a standalone application using the native window system, but the browser-based IDE is also available. See below for instructions on how to switch to that version.

## Download location

Visit https://franz.com/downloads/clp/survey where you will be asked to identify yourself and agree to the license terms. Then you will be directed to a page from which you can download the software.

### Platforms

The Express edition is available on these platforms:

- 32-bit Windows (x86 only)
- 64-bit macOS AMD64/Intel (x64_64) and Apple Silicon (arm64)
- Linux:
  - NEW 64-bit ARM64 (aarch64)
  - NEW 64-bit AMD64/Intel (x86_64)
  - 32-bit (x86)
- 32-bit FreeBSD (x86, note no IDE)

Download the desired installation file.

## Installation

### Installation On Windows

You download an `.exe` file. Run that file. The installation is signed and certified. You will be asked if you want to install and you will be asked to elevate to administrator privileges for installation. If you get a warning from Windows Defender, especially when running on Windows 11, please let us know if the following does not fix the problem:

1. Open command prompt as administrator and change directory to `c:\Program Files\Windows Defender`
2. Run `MpCmdRun.exe -removedefinitions -dynamicsignatures`
3. Run `MpCmdRun.exe -SignatureUpdate`

Once installed, Allegro CL Express will come up as a standalone app. You can have it come up instead in your default browser. The choice can be made on the Options dialog (click on Tools Menu | Options). The option Run the IDE in a Web Browser controls whether the IDE comes up as a Windows app or in a browser tab. Initially it is not selected, but selecting it, as shown in the illustration, causes the IDE to come up in a browser tab:

Save options changes with the Tools Menu | Save Options Now.

When the IDE runs in a browser tab, you may trigger a Windows Defender Firewall dialog. The IDE process and the browser communicate over the network via sockets using `localhost`. This is what may trigger the Windows dialog. Denying or allowing the access does not matter. If such a dialog appears, we recommend selecting Cancel from that dialog.

### Installation on macOS (AMD64/Intel and Apple Silicon)

NOTE: the download for macOS currently works on Apple Silicon via Rosetta 2 (emulation). We expect a native port to Apple Silion to be available in the first half of 2022.

Allegro CL 10.1 Express on macOS uses the browser version of Common Graphics and the IDE, as said in the Introduction above.

If you do not have admin privileges you will be prompted from time to time to verify a step by entering a username and password for a user with such privileges. Do so whenever asked.

1. Assert that the download is trusted by executing the following command in `Terminal`:

    $ xattr -d com.apple.quarantine ~/Downloads/acl10.1express-macosx-x64.dmg

2. Then in the `Downloads` directory in the Finder, double-click on the file `acl10.1express-macosx-x64.dmg`. This will mount the image and open a Finder window on it:

3. Drag the `AllegroCL64express` icon to the `Applications` folder icon. When copying completes, the file will appear in the `/Applications` folder. You can drag it to the Dock if desired. The `.dmg` file is no longer needed and can be deleted.

Allegro CL Express is now installed. Run `Allegro CL Express.app` from the `/Applications` folder or using the icon in the Dock. This should start Allegro CL Express.

If (because the `xattr` command above was not executed) a warning dialog appears saying AllegroCL64express can't be opened because Apple cannot check it for malicious software, try the following:

1. Open the parent directory with the Finder.
2. Right click and `open` it.
3. Agree to continuing.

If all goes well, Allegro CL Express will start with the IDE in your default browser and you will see an editor window and the listener window (named the Debug window).

### Installation on Linux

There are 32-bit and 64-bit versions of Express on Linux. We recommend users match the Express installation to the operating system on which they will run Express. For 64-bit Linux install the 64-bit Express and for 32-bit Linux install the 32-bit Express. Installing 32-bit Express on 64-bit Linux will require additional library installation not covered here.

The installation steps are:

1. We assume you downloaded `acl10.1express-[platform].bz2` ([platform] names the platform -- `linux-x64`, `linux-x86`, `linux-aarch64`, or `freebsd`), to `/tmp` and that you wish to install into `/usr/local/acl10.1express` (modify the command as necessary for other locations)

2. Run the `tar` command appropriate for your platform:

    $ tar jxf /tmp/acl10.1express-linux-x64.tbz2 -C /usr/local
    $ tar jxf /tmp/acl10.1express-linux-x86.tbz2 -C /usr/local
    $ tar jxf /tmp/acl10.1express-linux-aarch64.tbz2 -C /usr/local
    $ tar jxf /tmp/acl10.1express-freebsd-x86.tbz2 -C /usr/local

## Post-installation information

### Browser-based IDE help

Allegro CL documentation is available from the Help menu and the F1 button. Your browser must allow pop-ups for the documentation to be displayed. If you see a brief message after trying to display a doc page that a pop-up has been blocked, modify your browser setting to allow pop-ups in the Allegro CL tab.

### Installed executables

- Windows: there is a single executable on Windows called `allegro-express.exe` and available on the Start Menu.
- Linux: the IDE executable is named `allegro-express`, but there is also the IDE-less `alisp`.
- macOS: this platform is the same as Linux, however they live in the `/Applications/AllegroCL64express.app/Contents/Resources/` directory.
- FreeBSD: since there is no IDE on this platform, `alisp` is the sole executable.

### Other available executables

To make the downloadable file as small as possible, we have restricted the number of executables included with the Express distribution.

We have omitted these images, which you can build from instructions in the file `readme.txt`:

- `mlisp`: Modern-mode base Lisp image, international (16-bit characters)
- `allegro`: Modern-mode IDE image, international (16-bit characters)

### Get patches after installation

All users should update their installed Allegro CL Express after installation, and should do so regularly thereafter.

On platforms other than Windows, run in a shell from the Allegro CL Express installed directory:

    $ ./update.sh -u

On Window, execute the appropriate Start menu item, or display the Download Patches dialog with the Install | Update menu item.

See also sys:update-allegro.

Copyright (c) 2022, Franz Inc. Lafayette, CA., USA. All rights reserved.

ToC | DocOverview | CGDoc | RelNotes | FAQ | Index | PermutedIndex
| Allegro CL version 10.1