Resin Installation Quick StartResin 3.0
Resin 3.0

Web Applications
Servlets and Filters
Admin (JMX)
EJB 3.0

Quick Start
Standalone Web Server
Standalone Web Server

  1. Quick Start for the Impatient
  2. Preconditions
  3. Resin Web Server
    1. Windows
    2. Unix (including MacOS-X)
  4. Resin with Apache
  5. Resin with IIS

Quick Start for the Impatient

The Resin standalone web server starts listening to HTTP requests on port 8080 and listens on port 6802 for any Apache or IIS plugin. Resin can then be used for development or evaluation. The steps are:

  1. Install JDK 1.4 or later. On Unix, set the JAVA_HOME variable or link /usr/java to the java home. On Windows, check to make sure the JDK installation set JAVA_HOME correctly.
  2. unzip/untar the Resin download
  3. On Unix, execute use ./configure; make; make install
  4. Start resin-3.0.0/bin/ on Unix or resin-3.0.0/httpd.exe on Win32
  5. Browse http://localhost:8080
  6. Add JSP files like resin-3.0.0/doc/hello.jsp. The URL in your browser will be http://localhost:8080/hello.jsp
  7. Add servlets like resin-3.0.0/doc/WEB-INF/classes/test/
  8. Add .war files like resin-3.0.0/webapps/hello.war, url in your browser is http://localhost:8080/hello
  9. Create web-apps directly like resin-3.0.0/webapps/hello/index.jsp url in your browser is http://localhost:8080/hello. Create a file resin-3.0.0/webapps/hello/WEB-INF/web.xml to configure the 'hello' web application.
  10. If needed, modify the Resin configuration in resin-3.0.0/conf/resin.conf
  11. .war files will be deployed in resin-3.0.x/webapps.

Until you're ready to deploy the server, those are all the steps needed to get started with Resin.


Resin needs Java before it can run. It needs JDK 1.4 or a later JDK.

Sun's JDK for Windows, Solaris, and Linux can be found at Sun also has links to some other ports of the JDK.

Linux users can also check out the IBM JDK.

Resin Web Server

The easiest and fastest Resin configuration uses the Resin as the primary or only web server. This configuration provides a Java HTTP server. We recommend you start with this before trying any other configuration.

The server listens at port 8080 in the default configuration and can be changed to the HTTP port 80 during deployment.


  1. Install JDK 1.4 or later.
  2. Check that the environemnt variable JAVA_HOME is set to the JDK location, i.e "c:\j2sdk1.4.1_01"
  3. Unzip
  4. Define the environment variable RESIN_HOME to the location of Resin, for example "c:\resin-3.0.0"
  5. Execute resin-3.0.0/httpd.exe
  6. Browse http://localhost:8080

Unix (including MacOS-X)

  1. Install JDK 1.4 or later and link /usr/java to the Java home or define the environment variable JAVA_HOME.
  2. tar -vzxf resin-3.0.0.tar.gz
  3. cd resin-3.0.0
  4. ./configure
  5. make
  6. make install
  7. Execute resin-3.0.0/bin/
  8. Browse http://localhost:8080

For more details, see the Resin standalone configuration page.

Resin with Apache

If you are already using Apache for your web server, you can use Resin with Apache. This configuration uses Apache to serve html, images, PHP, or Perl, and Resin to serve JSPs and Servlets.

The Apache configuration uses two pieces: a C program extending Apache (mod_caucho) and Java program supporting servlets and JSP (srun.) The two pieces communicate with a special high-speed protocol.

To configure Apache with Resin, you must configure both Apache and Resin. The Resin configuration is identical to Resin's httpd configuration. The Apache configuration tells Apache how to find Resin.

  1. On Unix only, compile using ./configure --with-apache; make
  2. Make any needed Apache httpd.conf changes
  3. Make any needed Resin resin.conf changes
  4. Restart Apache
  5. Start Resin with resin-3.0.0/bin/ on Unix or resin-3.0.0/httpd.exe on Windows.

On Unix, you'll run configure using --with-apache and then make:

unix> ./configure --with-apache=/usr/local/apache
unix> make
unix> make install

For more details, see the Resin with Apache configuration page.

Resin with IIS

You can also combine IIS and Resin. IIS serves static content like html and images and Resin serves JSPs and Servlets. The IIS configuration requires two pieces: isapi_srun.dll, an ISAPI extension which lets IIS talk to Resin, and srun, Resin's Java support.

For this setup you must configure both IIS and Resin. The Resin configuration is identical to Resin's httpd configuration. The IIS configuration tells IIS how to find Resin.

  1. Setup the registry and IIS using resin-3.0.0/bin/setup
  2. Any needed Resin resin.conf changes
  3. Restart IIS
  4. Start Resin with resin-3.0.0/httpd.exe.

For more details and troubleshooting steps, see the Resin with IIS configuration page.

Standalone Web Server
Copyright © 1998-2005 Caucho Technology, Inc. All rights reserved.
Resin® is a registered trademark, and HardCoretm and Quercustm are trademarks of Caucho Technology, Inc.