Skip to content
Architecture > Configuration Guide

How Do You Configure AMI?

Overview

Browse to the amione/config directory and create a new, empty local.properties file and place each property to override on its own line in the format property.name=value

Hint: You can copy the default.properties to local.properties to get started with good default values.

You might ask, why doesn't AMI just come with a default local.properties? This is so that when you download and update to a new version of AMI this file will not be overwritten, hence maintaining your existing settings.

Note

For instructions on how to encrypt properties, see the encryption section of the docs.

Example

Below is a sample local.properties file:

#My local.properties located under config directory
#Note, lines starting with pounds are comments (except for #INCLUDE)

#Override the http port to standard port
http.port=80

#Override the location of the access.txt file
users.access.file=/home/myname/access.txt

#Process and include properties from a custom properties file
#INCLUDE home/env_specific.properties

#Define my own custom value
my.custom.value=5

#Reference my custom value
ami.frames.per.second=${my.custom.value}

#Append to an existing variable
ami.datasource.plugins=$${ami.datasource.plugins},com.my.Plugin

#Remove a specific property in any of AMI's prepackaged configuration (root.properties, speedlogger.properties, defaults.properties). 

#UNDEFINE  speedlogger.sink.FILE_SINK.maxFiles=10