eas.yml
eas.yml is the typical main configuration file for the container easydb-eas (which is hosting the easydb asset server). But it is not the only one. For more information on this, see configuration.
eas.yml is read from the subdirectory config of the base directory which was chosen during installation. The path outside the container would be /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.