2 Running the application

Building the jar

The first step is to run the build-standalone script, e.g.

grails prod build-standalone

or

grails -Dgrails.env=demo build-standalone our_cool_demo.jar

If you pass the --jetty flag the embedded server will be Jetty instead of the default Tomcat, for example

grails prod build-standalone --jetty

or

grails -Dgrails.env=demo build-standalone our_cool_demo.jar --jetty

You can change the default embedded server to Jetty by adding this to BuildConfig.groovy:

grails.plugin.standalone.useJetty = true

If you've set Jetty to the default, you can force a Tomcat build later with the --tomcat flag:

grails build-standalone --tomcat

Build Configuration

There are several configuration settings that you can use to change how the jar is built; add any of these to BuildConfig.groovy to override the defaults:

Running the server

As long as the target machine has Java 5 or higher available, all you need to do next is run

java -jar /path/to/jar_name.jar

There are several arguments you can pass to customize how the application runs, using name=value syntax:

1. context, the context name; if not specified it defaults to "" (the "root" context)
2. host, the host name; if not specified it defaults to "localhost"
3. port, the HTTP port; if not specified it defaults to 8080
4. httpsPort, the HTTPS port; there is no default for this, but if specified you can also specify the keystore path and password
5. keystorePath or javax.net.ssl.keyStore, the SSL keystore path; if not specified a temporary keystore will be generated
6. keystorePassword or javax.net.ssl.keyStorePassword, the SSL keystore password; required if an existing keystore path is specified
7. truststorePath or javax.net.ssl.trustStore, the SSL truststore path
8. trustStorePassword or javax.net.ssl.trustStorePassword, the SSL truststore password; required if an existing truststore path is specified
9. enableClientAuth, whether to enable client auth, defaults to false
10. workDir, the working directory where the war file is extracted, defaults to the system temp directory
11. enableCompression, whether to enable compression (Tomcat only)
12. compressableMimeTypes, a comma separated list of MIME types for which HTTP compression may be used; defaults to the Tomcat defaults, "text/html,text/xml,text/plain"
13. sessionTimeout, the session timeout in minutes; defaults to 30
14. nio or tomcat.nio, whether to use NIO; defaults to true
15. serverName, a specific value to use as HTTP Server Header, by default tomcat will use Apache-Coyote/1.1 if none set at application level (Tomcat only)
16. enableProxySupport, enables support for X-Forwarded headers by adding a pre-configured RemoteIpValve, defaults to false (Tomcat only)

In addition, if you specify a value that is the name of a system property (e.g. 'home.dir'), the system property value will be used.

For example running

java -jar /path/to/jar_name.jar

will start a server at http://localhost:8080/ and

java -jar /path/to/jar_name.jar context=cool_demo port=9000

will start a server at http://localhost:9000/cool_demo

java -jar /path/to/jar_name.jar context=cool_demo port=8080 httpsPort=8443

will start a server at http://localhost:8080/cool_demo and will also support SSL at https://localhost:8443/cool_demo