DE EN EN (Google)

eas.yml

This configuration is placed outside of the container, e.g. into /srv/easydb/config/eas.yml, assuming your base directory is /srv/easydb.

In yml-files created by Programmfabrik we use an indentation of 2 spaces per ⇨.

variable
type default description
canonical-name string easydb-eas external name of EAS
docker-hostname string easydb-eas name of docker container
log-level one of debug, info, warn, error info log level
pgsql connection settings for PostgreSQL
host string easydb-pgsql
port integer 5432
username string ***
password string ***
database string eas
smtp mail server settings
server string mail
from-address string root@localhost
hostname string localhost
imagemagick ImageMagick settings
policy IM policies
⇨⇨resource IM resource policies
⇨⇨⇨memory string 1024MiB
⇨⇨⇨map string 2048MiB
⇨⇨⇨width string 64KP
⇨⇨⇨height string 64KP
⇨⇨⇨area string 512MB
⇨⇨⇨disk string 4GiB
apache-mmap string "on" Alternative: "off". Whether to use Apache’s EnableMMap, see here.
num-workers integer 1 Maximum simultaneous processes of time-intensive work. Also see here. Should not be bigger than the number of CPU cores.
num-soffice integer 2 Maximum simultaneous processes of office documents. Must always be bigger than num-workers.
num-services integer 5 See here.
trusted-net string Networks with full access to EAS API, for example: 10.12.12.0/24. Requests originating from these networks can manipulate the asset server without further restrictions, so use with care. Only the easydb-server is required to have this full access. In addition to the value set, the default Docker network (172.0.0.0/8) and localhost (127.0.0.1) already have this access, so usually no extra configuration is required. It is possible to set multiple networks separated by space, e.g. 10.12.0.0/16 10.13.0.0/16. You should check https://<external-address>/eas/config to ensure the restrictions are in place. When configured correctly, HTTP 403 (“Access forbidden”) is returned.

example

canonical-name: https://official.example.com
log-level: debug
pgsql:
  host: pgsql
  port: 15432
  username: docker
  password: d8s2H3.mgy/ap6
  database: eas
num-workers: 4
num-soffice: 5
trusted-net: 10.123.123.0/24

smtp:
  server: relay.example.com
  hostname: easydb-server.example.com
  from-address: noreply@example.com

In many cases you do not need this file at all.

The typical eas.yml only contains num-workers and num-soffice.