Logo

github Download
AcraServer configuration

AcraServer configuration #

Here we describe how to set up AcraServer to reach a state where it can process queries.

List of all command line flags for AcraServer is located here.

Configuration file #

There are two ways of configuring AcraServer:

  • via command line flags
  • via configuration file

The YAML file is passed with --config_file=path/to/config.yml flag. To use this file as configuration source, you simply move flags into it, --foo=1 will become foo: 1 and --bar=test will become bar: "test".

Different configuration sources can be mixed if that makes sense in your situation.

Listener #

AcraServer will be listening on some default ports (API on 9090, SQL proxy on 9393) if not configured to do otherwise. Related flags are located here. As a simple example we can set both host and port like this: --incoming_connection_string=tcp://127.0.0.1:13306.

It is also important to configure TLS, so the application/clients will have secure connection to AcraServer.

Database #

How to let Acra know which DBMS you are using and how to connect to it.

If you are using MySQL or MariaDB, add --mysql_enable=true flag.

If you are using PostgreSQL, add --postgresql_enable=true flag.

Then, configure the database address with --db_host and --db_port. Don’t forget to also configure TLS: set up additional root CA if needed, client certificates and so on.