Installation of your GendL-based System

| ^UP^ | Next->

You have several options for developing and deploying applications using GendL and Genworks GDL. GendL refers to an open-source project hosted at common-lisp.net whose copyright is owned by Genworks and which is licensed under the GNU Affero General Public License The AGPL licensing means essentially that GendL and its derivatives can be used free of charge in any way you want, as long as you comply with AGPL by making available your application source code to your users. If you were to host or distribute a compiled GendL application without complying with AGPL requirements, you would be putting yourself and any company you're associated with into legal jeopardy.

Please do not be concerned about legal jeopardy, however, as there are several ways to make good use of GendL and KBE while avoiding this risk:

  • Host your application source code at a public repository such as Github or a Gitlab instance.
  • Host your running applications using our Hosting Infrastructure (coming soon), which will automatically take care of offering source code to users.
  • Contact Genworks and arrange to purchase a commercial Genworks GDL seat (these seats are built with commercial Allegro Common Lisp and come with technical support as well as other Enterprise-oriented features.)

Up to date prebuilt GendL executable images, based on Clozure CL 1.12, are available for Windows and Linux on 64-bit Intel processors. For other Operating Systems and Processors, you can use the Docker container approach (see below), or build GendL from source on a compliant CL implementation such as Allegro CL, Clozure CL (CCL), Clasp, LispWorks, or SBCL, on your OS platform of choice (see below).

Prebuilt GendL for Windows

You can download the latest prebuilt GendL for Windows from this zip file link (we suggest using 7-zip.org to unzip this), or from this setup executable (note: the setup executable currently shows up as "Unknown Publisher" which is expected. If you have security concerns regarding your download, please contact Genworks.)

Once it is finished extracting or installing, you may run the run-gdl.bat script which can be found at the toplevel of then extracted or installed directory. This script will launch Gnu Emacs, which will in turn launch and initialize a GendL instance as a subprocess.

Note that you may have to override the default Windows security settings to allow the script to run, when running it for the first time.

Prebuilt GendL for Linux

You can download the latest prebuilt GendL for Linux from this link. This prebuilt Clozure CL-based GendL distribution assumes that you already have Gnu Emacs installed on your Linux system (available through most Linux package managers).

Once it is finished extracting, you may run the run-gdl script which can be found at the toplevel of then extracted directory. This script will launch emacs, which will in turn launch and initialize a GendL instance as a subprocess.

GendL as a Docker container

You can run the latest development version of GendL on any operating system where you have a bash shell and Docker installed (free version sufficient). On Windows, the easiest way to get Docker and a bash shell is by installing the Microsoft-supported Windows System for Linux 2 (WSL2)

To get GendL running in a container, follow these steps:

  1. Clone the GendL repository, for example with the command git clone https://gitlab.common-lisp.net/gendl/gendl.git
  2. . This repository will contain a file docker/run. Run this script. It will fetch and run a prebuilt container image matching the repository branch you have cloned. You may choose your branch from the official GendL codebase branches:
    master
    The current official stable released version.
    devo
    The current version under active development. Contains newest features but may be unstable.
    release/1598
    The current release candidate for GendL 1598 (or other version), used for producing beta releases
  3. Load the file from the repository: emacs/gdl.el into your emacs (e.g. using M-x load-file)
  4. In emacs, connect to the GendL server using M-x slime-connect and specify the host as localhost and the port as 4200

GendL compiled from source

If you are already set up with Common Lisp and Quicklisp, you can load and start GendL with the following commands: (ql:quickload :gendl) (gendl:start-gendl!). If you'd like to work with the latest development ("devo") version of GendL, then you may clone its repository into your quicklisp/local-projects/ directory, then the above command will load it from there rather than its official distribution location (the official distribution will typically be built from the latest master branch. In order to clone the devo branch, the commands would be:
git clone https://gitlab.common-lisp.net/gendl/gendl.git; cd gendl; git checkout devo

Commercial Genworks GDL

Genworks offers commercial Genworks GDL distributions built with the commercial Allegro Common Lisp system. These distributions require an encrypted license file to run and are available through an email-based download gateway.

If you would like to inquire about an entitlement for supported commercial Genworks GDL, then please contact Genworks at licensing@genworks.com and you will be provided with further information.