Skip to content
Helma web framework
Java JavaScript Other
Latest commit dd8f8b6 Mar 12, 2014 @oberhamsi oberhamsi bump version
Failed to load latest commit information.
apps/manage Merge remote-tracking branch 'manage/master' into subtree Mar 27, 2012
build Changed documentation link again Sep 21, 2009
lib Update to jetty-ajp jar from Jetty 6.1.22 with patch for jetty issue … Jan 25, 2010
licenses Replace GPLed Diff with BSD licensed java-diff from The c… Sep 22, 2009
modules fix Object.clone for `null` properties Mar 27, 2012
scripts The init script was intially written for Debian, where sh is typicall… May 10, 2009
src bump version Mar 12, 2014
static * Update helma logo. Apr 4, 2007
.gitignore adding .gitignore Mar 27, 2012
README.txt Toggle version to 1.7.0 and clean up build file: Remove obsolete CVS … Dec 15, 2008 removed all demo apps as for distribution are now loc… Jun 18, 2002
build.xml bump version Mar 12, 2014
license.txt updated range of years of copyright notice in the license to include … Aug 6, 2008
start.bat Implement -a switch to helma launcher that allows to explicitly list … May 29, 2009


This is the README file for version 1.7.0 of the Helma Javascript
Web Application Framework.


With the default package installed, all you need to do to get 
started is:
 -> make sure that you have Java 1.4 or higher installed
 -> call, resp. start.bat depending on your platform
 -> direct your web browser to http://localhost:8080/
See below for more detailed information.


Helma is an open source web application framework for fast 
and efficient scripting and serving of your websites and 
Internet applications.

Helma is written in Java and employs Javascript for its server-side 
scripting environment, removing the need for compilation cycles and 
reducing development costs while giving you instant access to leverage 
the whole wealth of Java libraries out there.

Helma pioneered the simple and codeless mapping of application objects 
to database tables, which has only recently come into vogue with other 
web frameworks. In addition, an embedded object-oriented database 
performs automatic data persistence of unmapped objects.

Helma has proven itself to be stable and fast, capable of serving high 
traffic sites with hundreds of thousands of dynamic pages per day. The 
Austrian Broadcasting Corporation, popular weblog hosting sites such 
as,, and, among many others, have 
successfully been deploying Helma for several years now.


You need a Java virtual machine 1.4 or higher to run Helma.

For Windows, Linux and Solaris you can get a Java runtime or development 
kit from If you are on Mac OS X, 
you already have a Java runtime that will work well with Helma.

For other operating systems, please consult the documentation about the 
availabilty of a Java 1.4 (or higher) runtime.


Simply unzip or untar the contents of the archive file into any place 
on your hard disk. Start Helma by invoking start.bat or from  
the command line, depending on whether you are on Windows or 
Linux/Unix/MacOSX. If the java command is not found, try setting the
JAVA_HOME variable in the start script to the location of your Java

You may also want to have a look at the start script for other settings.
You can adjust server wide settings in the file. For
example, you should set the smtp property to the name of the SMTP server
that Helma should use to send Email. Applications can be started or
stopped by editing the file through the web interface
using the Management application that is part of Helma.

If you manage to get it running you should be able to connect your
browser to http://localhost:8080/ or 
(port 8080 on the local machine, that is).

Helma comes with a version of Jetty, a lightweight yet industrial strenth
web server developed by Mortbay Consulting. See
for more information. While Jetty works well for deploying real web sites,
you may want to run Helma behind an existing web server. This is most
easily done by running Helma with the AJPv13 listener which allows you to
plug Helma into any web server using the Apache mod_jk module. See for more 
information on mod_jk and AJPv13.

Finally, Helma can be plugged into Servlet containers using Servlet
classes that communicate with Helma either directly or via Java RMI.
(Be warned that these options may be harder to set up and maintain though,
since most of the recent development efforts have been geared towards the
mod_jk/AJPv13 setup.)


After installing and running Helma, you will be able to access  
introductions to the features of Helma and the various included 
development tools. Further information you will find on the 


Please join us on the Helma mailing lists where we will be happy to 
answer any further questions you may have!

Something went wrong with that request. Please try again.