In the Configuring Virtual Hosts in Geronimo-Tomcat section we describe how to define a Virtual Host in the Geronimo's config.xml so applications could be deployed to specific hosts ( Virtual Hosts) with a minimal configuration on the application deployment plans side. The need to define Virtual Hosts at the server level ( config.xml ) only applies to Geronimo with Tomcat distributions.

For the Jetty distribution of Apache Geronimo this configuration is dramatically simpler. You just need to define the <virtual-host> tag in the application's deployment plan and make sure that host name ( virtual host ) can be resolved by the client. There is virtually no additional configuration needed on the Geronimo server side.

If you compare this deployment plan with the one described in the Quick start - Apache Geronimo for the impatient section you will note that only one line has been added, that is <virtual-host>virtualhost1.com</virtual-host>. This is all you need to define a virtual host in Geronimo with Jetty.

To deploy this application you can use the --inPlace option from the deployer tool so you wont need to package the application nor copy it anywhere else. Just run the following command:

Note that even when the successful deployment message on screen shows that the application has been deployed to the http://XYZ:8080/hello host, the application will only be accessible via the virtual host previously defined in the <virtual-host> tag on the geronimo-web.xml deployment plan.