To set up Seam, use the following software:


  • JBoss 4.2.2.GA
  • JBoss Seam 2.0.0.GA
  • Eclipse Europa for JEE developers
  • JDK 1.5.x or above
  • Apache Ant 1.6.x (do not use 1.7!)


Environment variablesEdit

  • Ensure that JAVA_HOME is pointing to the JDK
  • Ensure that ANT_HOME is pointing to the Ant directory
  • Make sure that "%ANT_HOME%\bin" is in the PATH variable


  • Put the location of the JBOSS AS in the file (has to be absolute)


  • Set up the JBoss AS Runtime
    • Go to Windows --> Preferences --> Server --> Installed Runtimes
    • Click Add
    • Select JBoss 4.2 Runtime
    • Browse for the installation directory
  • Set up the server to run off the runtime
    • In the JBoss Server View, select New Server
    • Select your newly created runtime
  • Test the server by starting it up
    • If there are problems, check the end of this guide for technical issues on JBoss

HSQLDB (a.k.a. Hypersonic)Edit

  • The embedded database within JBoss
  • I am using it in its default configuration, which means that data will not be retained when the JBoss Application Server is shut down


The above configuration is for Windows XP. I've set up the same environment on Linux (Kubuntu 7.10) without much difficulty as well.