Skip to content

Overview

Configuration file location

As mentioned in the installation instructions, you can override application configuration properties by creating a file at the following location:

$TOMCAT_HOME/.grails/openboxes-config.properties

If you are deploying the application to a server, the config file is usually located under the TOMCAT_HOME/.grails/openboxes-config.properties.

sudo mkdir /opt/tomcat/.grails
sudo touch /opt/tomcat/.grails/openboxes-config.properties

If you are having trouble locating where the application is looking for the file you can determine the path by deploying the application to Tomcat and checking the log file. The first few lines of the Tomcat catalina.out file display the path(s) being used.

Example log file

INFO: Deploying web application archive openboxes.war
Using configuration locations [classpath:openboxes-config.groovy, classpath:openboxes-config.properties, 
file:/opt/tomcat/.grails/openboxes-config.groovy, file:/opt/tomcat/.grails/openboxes-
config.properties] [staging]
Unable to load specified config location classpath:openboxes-config.groovy : class path resource 
[openboxes-config.groovy] cannot be opened because it does not exist
Unable to load specified config location classpath:openboxes-config.properties : class path resource 
[openboxes-config.properties] cannot be opened because it does not exist
Unable to load specified config location file:/opt/tomcat/.grails/openboxes-config.groovy : 
/opt/tomcat/.grails/openboxes-config.groovy (No such file or directory)

You can safely ignore the Unable to load specified config location errors for the file locations that you are not using. Notice in the example log file that there are four (4) configuration locations, but only three (3) config locations that could not be loaded. That means that there was one (1) file found and loaded at one of the config file locations. Namely,

file:/opt/tomcat/.grails/openboxes-config.properties

That will tell you which file you need to edit.

Note

If none of the files were loaded, then you should create a new file at the location of the openboxes-config.properties file.