Configure Akka through akka.conf

The configuration file resides in the ‘$AKKA_HOME/config’ directory and is named ‘akka.conf’. It imports the reference configuration ‘$AKKA_HOME/config/akka-reference.conf’, but you can override any option you want. Just copy the configuration over to ‘akka.conf’ and edit it as you please.

Here is a full example of all its options.

####################
# Akka Config File #
####################
 
# This file has all the default settings, so all these could be remove with no visible effect.
# Modify as needed.
 
<log>
  filename = "./logs/akka.log"
  roll = "daily"  # Options: never, hourly, daily, sunday/monday/...
  level = "debug" # Options: fatal, critical, error, warning, info, debug, trace
  console = on
  # syslog_host = ""
  # syslog_server_name = ""
</log>
 
<akka>
  version = "0.6"
 
  # FQN to the class doing initial active object/actor
  # supervisor bootstrap, should be defined in default constructor
  boot = ["sample.java.Boot", "sample.scala.Boot", "se.scalablesolutions.akka.security.samples.Boot"]

  <actor>
    timeout = 5000           # default timeout for future based invocations
    serialize-messages = off # does a deep clone of (non-primitive) messages to ensure immutability
  </actor>
 
  <stm>
    service = on
    max-nr-of-retries = 10
    restart-on-collision = off # (not implemented yet) if 'on' then it reschedules the transaction,
                               # if 'off' then throws an exception or rollback for user to handle
    wait-for-completion = 1000 # how long time in millis a transaction should be given time to complete when a collision is detected
    wait-nr-of-times = 3       # the number of times it should check for completion of a pending transaction upon collision
    distributed = off          # not implemented yet
  </stm>
 
  <remote>
    <server>
      service = on
      hostname = "localhost"
      port = 9999
      connection-timeout = 1000 # in millis (1 sec default)
    <server>
    <client>
      reconnect-delay = 5000    # in millis (5 sec default)
      read-timeout = 10000      # in millis (10 sec default)
    <client>
  </remote>
 
  <rest>
    service = on
    hostname = "localhost"
    port = 9998
    filters = "[se.scalablesolutions.akka.security.AkkaSecurityFilterFactory]"              # List with all servlet filters to use
    authenticator = "se.scalablesolutions.akka.security.samples.BasicAuthenticationService" # The authentication service to use
  </rest>
  
  <storage>
    <cassandra>
      hostname = "127.0.0.1"        # IP address or hostname of one of the Cassandra cluster's seeds
      port = 9160
      storage-format = "scala-json" # Options: java, scala-json, java-json, protobuf
      consistency-level = "QUORUM"  # Options: ZERO, ONE, QUORUM, ALL 
    </cassandra>
    <mongodb>
      hostname = "127.0.0.1"        # IP address or hostname of the MongoDB DB instance
      port = 27017
      dbname = "mydb"
    </mongodb>
  </storage>
</akka>