Dragonfly welcome | Dragonfly web framework

Getting Started

Setting up Dragonfly is easy, all you need is newLISP and a web server (like Apache). As newLISP compiles virtually everywhere, you can host a Dragonfly-based site just about anywhere, even on shared web hosts!

At first one question

Why is this guide so damn narrow? Because most people work on wide screens. So put the Dragonfly Guide on the left and open Your development window in a new browser window on the right. This way the Dragonfly User Guide will always be visible.


Dragonfly requires the following to work:

For magic redirection, Apache web server is recommended.

If you're using a custom web server, you might want to setup your own redirection script based on the .htaccess file.

Running Dragonfly Remotely

Step 1: Copying Files

There are three things you must copy into your site's root to install Dragonfly. These items are found inside of the example-site folder:

  1. The dragonfly-framework folder
  2. index.cgi
  3. .htaccess (This file is hidden but important!)

By "site root" we mean the folder that represents your basic web address, for example if your website is located at:


If on your webserver that is represented by this folder (called the "site root"):


Then that's the folder you'll want to copy the files into.

If you'd like Dragonfly to live somewhere else inside your site root, or have newlisp installed outside of your /usr/bin folder, click here for instructions.

Step 2: Configure Dragonfly

You can configure various aspects of Dragonfly's behavior by editing the config.lsp file in the dragonfly-framework folder.

Read through the comments (they begin with a semi-colon) for instructions on what the settings are for.

By default, Apache will send all .html files through Dragonfly for further processing (if necessary) to allow for PHP-like development. If you wish to change this behavior, open the .htaccess file in the site root and read through the comments there.

Step 3: That's it!

You're ready to run Dragonfly!

Trouble? Questions? Visit the Dragonfly forum and we'll help you out!

Running Dragonfly Locally

You can easily run this entire site (or your own) on your computer using newlisp's built-in web server.

This is covered in detail in the section: Working Locally.


Rendered in 0 milliseconds. Used 83 KB of memory, 58 KB for Lisp Cells.