revServer Configuration

Mike Bonner bonnmike at
Tue Jul 20 13:16:31 EDT 2010

Someone correct me if I have any mis-steps here but:

You shouldn't need to set the variable unless you you change the
hierarchy of the revserver folders.

There is a folder that contains revserver and its supporting folders.
Copy all of those (not the holding folder) to

To set it up to use with the system web address
( rather rather than user space
Edit the /etc/apache2/httpd.conf file.  If you look for the line that
says ScriptAliasMatch it should already contain an entry for the
CGI-Executables folder, so that part is done.
Locate the section that starts out with <Directory
Inside that section make sure the Options line has ExecCGI tacked on to the end.
Near the bottom of that section add the 2 following lines
AddHandler rev-cgi .irev
Action rev-cgi /cgi-bin/revserver
Finally, find the line that says DirectoryIndex. It should already
list index.html. add index.irev so that it will auto parse an
index.irev file if a folder sans specific file is looked for.
restart the webserver. Easiest way is in system preferences, sharing,
take the check out of web sharing, wait a few moments then put it back

at this point, to enable it in a userspace, change into /etc/apache2/users
there should be a file username.conf
edit that file.
same deal, make sure that ExecCGI is tacked on to the end of the
options line, add the addhandler and action lines from above and save
it.  No need to worry about the directory index.
when done, restart the server again.

All this is assuming yours is setup with the same structure as mine,
but even if its not should be possible to figure out what is where by
reading the conf files.

And sorry the formatting isn't very good for this, don't have much time atm.

On Tue, Jul 20, 2010 at 12:58 PM, Gregory Lypny
<gregory.lypny at> wrote:
> Hello everyone,
> Despite having an On-Rev account, I'd like to get revServer running on a machine at work but I don't understand the configuration instructions I found on rev Lessons.  Under the Overview section, am I supposed to set REVSERVER_HOME to some path?  Where is this variable set and where does it reside?  This is followed by the CGI-When-You-Have-Access-to-Apache section, which I presumably do on my Mac, but it doesn't say how to create a handler to do the mapping that is required.  It also states parenthetically that this is not best practice (but not why), although there doesn't appear to be a section that describes what would be better practice.
> Is there a revServer Configuration for Dummies document out there?
> Regards,
> Gregory
> ----- Excerpt from rev Lessons ----
> revServer Overview
> The revServer engine runs as a CGI. Its only requirement is that it can find the data, extensions and handlers folders. It does this by defining its 'server home' on startup. The rules for this are as follows:
>    1) If there is an environment var REVSERVER_HOME, it uses its value
>    2) If there is a folder '/opt/revserver', it uses that
>    3) Otherwise, it derives the server home to be the folder containing the *resolved path* (i.e. path after symlink resolution) containing the revserver engine.
> Running as a CGI when you have access to Apache Config
> To get it to work as a CGI, the simplest way (although not particularly best practice) is to copy/upload the revserver binary and its folders directly into a cgi-bin folder. A suitable handler then needs to be added to the apache
> configuration to map .irev to /cgi-bin/revserver.
> If you have direct access to the apache config, then there is obviously a great deal more flexibility.
> _______________________________________________
> use-revolution mailing list
> use-revolution at
> Please visit this url to subscribe, unsubscribe and manage your subscription preferences:

More information about the Use-livecode mailing list