Configuration

Environment variables are used for differentiating configurations.

Runtime default settings

By default, the application loads the environment from /app/.env. The following variables are expected to exist:

• Runtime
  • APP_USER - account the services run under (e.g. vagrant, ubuntu)
  • APP_ROOT_DIR - top-level deploy directory (e.g. /app)
  • APP_APP_DIR - application source code directory (e.g. /app/app)
  • APP_VENDOR_DIR - directory with vendor libraries and code (e.g. /app/vendor)
  • APP_LOG_DIR - directory for logging (e.g. /app/log)
  • APP_RUN_DIR - directory to maintain PIDs and sockets (e.g. /app/run)
  • APP_TMP_DIR - temporary directory (e.g. /app/tmp)
  • APP_DATA_DIR - persistent data directory (e.g. /app/data)
• Elasticsearch service
  • APP_CONFIG_ES_CLUSTER - name of the elasticsearch cluster (e.g. default, learn more)
  • APP_CONFIG_ES_IPADDRESS - the IP address to bind to (e.g. 127.0.0.1)
  • APP_CONFIG_ES_AWS_ACCESS_KEY - an AWS access key to enable elasticsearch cloud clustering; if missing, IAM roles will be attempted (learn more)
  • APP_CONFIG_ES_AWS_SECRET_KEY - an AWS secret key to enable elasticsearch cloud clustering; if missing, IAM roles will be attempted (learn more)
  • APP_CONFIG_ES_AWS_EC2_GROUP - an AWS EC2 security group to restrict clustered nodes (learn more)
• Redis service
  • APP_CONFIG_REDIS_IPADDRESS - the IP address to bind to (e.g. 127.0.0.1)
  • APP_CONFIG_REDIS_KEY - the name of redis list or channel (e.g. logstash)

AWS EC2 Provider

When using the vagrant-aws provider plugin the following environment variables are expected to exist:

export AWS_ACCESS_KEY="XXXXXXXXXXXXXXXXX"
export AWS_SECRET_KEY="YYYYYYYYYYYYYYYYYYYYYYY/YYYYYYYYYYY"
export AWS_KEYPAIR_NAME="my-private-ec2-keypair"
export AWS_PRIVATE_KEY_PATH="$HOME/.ssh/my-private-ec2-keypair.pem"