Configuration

The configuration file uses YAML format and is provided to the service with the -c argument. If not specified, Facette will look for the /etc/facette/facette.yaml file.

For a complete example configuration file, see facette.yaml.

Main Settings

Key Type Default Description
listen string localhost:12003 Socket to listen on (use unix:/path/to/facette.sock for UNIX socket)
socket_mode string UNIX socket file mode (e.g. 0400)
socket_user string UNIX socket file owner (e.g. facette)
socket_group string UNIX socket file group (e.g. facette)
graceful_timeout int 30 Timeout before forcefully shutdown remaining connections
log_path string Logging file path (if empty, logging goes to stdout)
log_level string info Logging level (error, warning, notice, info or debug)
backend.driver string sqlite Back-end storage driver name (sqlite, pgsql or mysql)
backend.* See “Back-end Settings” below for details
frontend.enabled bool true Front-end activation flag
frontend.assets_dir string Front-end assets directory path (not used when compiling with builtin assets)
hide_build_details bool false Prevent build details from being exposed in API
read_only bool false Read-only flag, preventing modifications through API calls

Back-end Settings

SQLite

Key Type Default Description
backend.path string data.db SQLite database file path

PostgreSQL

Key Type Default Description
backend.host string localhost PostgreSQL host address
backend.port int 5432 PostgreSQL host port
backend.dbname string facette PostgreSQL database name
backend.user string facette PostgreSQL user name
backend.password string PostgreSQL user password

MySQL

Key Type Default Description
backend.host string localhost MySQL host address
backend.port int 3306 MySQL host port
backend.dbname string facette MySQL database name
backend.user string facette MySQL user name
backend.password string MySQL user password