Configure Tomcat running Airsonic

How to add Java parameters

As described in the RUNNING.txt doc provided by tomcat, you can create a file named setenv.sh or for windows setenv.bat in the Tomcat home bin folder to modify the java args.

Simply add the parameter like this -D${PARAMETER}=${ARGUMENT}.

Here is an example of a setenv.sh file (setenv.bat has slightly different syntax):

export JAVA_OPTS="$JAVA_OPTS -Dairsonic.home=/var/airsonic"

Airsonic home

Parameter = airsonic.home

Exemple = -Dairsonic.home=/var/airsonic

Dictates the folder where Airsonic will store its logs, settings, transcode binaries, index and database if using the default H2 database. As such it is recommended to backup this folder.

Default: /var/airsonic

Java memory allocation

Example = -Xmx512m

Here we will allocate 512 Mb of memory to Airsonic’s Java process.

How to configure Tomcat parameters

When running Airsonic with tomcat some parameters cannot be set using Java args but need to be direclty changed in tomcat.

Tomcat port

First you need to locate server.xml which by default should be in the ${TOMCAT_HOME}/conf/ folder (e.g. for Debian it will be /var/lib/tomcat8/conf/server.xml).

Then find the following similar statement:

<!-- Define a non-SSL HTTP/1.1 Connector on port 8180 -->
   <Connector port="8080" maxHttpHeaderSize="8192"
              maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
              enableLookups="false" redirectPort="8443" acceptCount="100"
              connectionTimeout="20000" disableUploadTimeout="true" />

Or

<!-- A "Connector" represents an endpoint by which requests are received
     and responses are returned. Documentation at :
     Java HTTP Connector: /docs/config/http.html (blocking & non-blocking)
     Java AJP  Connector: /docs/config/ajp.html
     APR (HTTP/AJP) Connector: /docs/apr.html
     Define a non-SSL HTTP/1.1 Connector on port 8080
-->
<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" />

Tomcat’s server.xml file cites it’s runs on port 8080. Change the Connector port="8080" port to any other port number.

Finally save the server.xml file and restart tomcat8.

Context path

Locate server.xml which by default should be in the ${TOMCAT_HOME}/conf/ folder (e.g. for Debian it will be /var/lib/tomcat8/conf/server.xml).

You will need to add the following right above the </Host> tag:

<Context path="" docBase="airsonic" debug="0" reloadable="true">
  <WatchedResource>WEB-INF/web.xml</WatchedResource>
</Context>
<Context path="ROOT" docBase="ROOT"> <!-- Default set of monitored resources -->
  <WatchedResource>WEB-INF/web.xml</WatchedResource>
</Context>

Finally save the server.xml file and restart tomcat8.