Configuration
Configuration files
A significant number of parameters can be configured. Parameters are configured in the environment files located in the conf/
directory.
To change the values, do not edit the .env files, simply set the values you want in conf/custom.env
. For instance, the first thing you want to add in conf/custom.env
is:
ARLAS_HOST=mydomain.com
Common files
conf/arlas.env
: General parameters of ARLAS Serverconf/elastic.env
: Configuration of elasticsearchconf/permissions.env
: Configuration of the service delivering permission descriptionsconf/persistence-file.env
andconf/persistence-postgres.env
: Configuration of the persistence servicesconf/restart_strategy.env
: Configuration of the restart strategy for every serviceconf/stack.env
: General parameters of the stackconf/versions.env
: Version of every single service (docker image)
Simple deployment
All common files and:
conf/apisix.env
: Configuration of APISIX gateway
See Simple ARLAS Stack configuration
IAM deployment
All common files and:
conf/arlas_iam.env
: Configuration of the IAM
See ARLAS with IAM configuration
Keycloak deployment
All common files and:
conf/arlas_keycloak.env
: Configuration of Keycloak for ARLAS
See ARLAS with Keycloak configuration
AIAS deployment
Same as IAM deployment and:
conf/aias.env
: Configuration of AIASconf/minio.env
: Configuration of the minio object store
See ARLAS Items and Assets Services (AIAS) configuration
AIAS with Keycloak deployment
Same as Keycloak deployment and:
conf/aias.env
: Configuration of AIASconf/minio.env
: Configuration of the minio object store
See ARLAS Items and Assets Services (AIAS) configuration with Keycloak
Host and domain
By default, the stack is deployed on http(s)://localhost/
. To deploy the ARLAS Stack on a different domain, simply change the ARLAS_HOST
environment variable in conf/stack.env
:
ARLAS_HOST=mydomain.com
If you are using arlas_cli
and you updated the $ARLAS_HOST
variable, then you need to run scripts/init_arlas_cli_confs.sh
to create again the arlas_cli
configuration file.
Variables
The current configurations are for tests only. These variables have to be changed for storing the data in reliable places:
ELASTIC_STORAGE
(conf/elastic.env
)ARLAS_PERSISTENCE_STORAGE
(conf/persistence-file.env
)POSTGRES_STORAGE
(conf/postgres.env
)POSTGRES_BACKUP_STORAGE
(conf/postgres.env
)
And for AIAS:
APROC_DOWNLOAD_DIR
(conf/aias.env
)APROC_INPUT_DIR
(conf/aias.env
)APROC_EMAIL_PATH_PREFIX_ADD
(conf/aias.env
)
Basemap
The basemap provided with the ARLAS Stack is the first zoom levels of protomaps. Download and replace conf/protomaps/world.pmtiles
to get all zoom levels.