Skip to content

Configure LAVA

Creating a superuser

Admins can create superuser accounts from the command line:

docker-compose exec lava-server lava-server manage createsuperuser
lava-server manage createsuperuser

Settings

LAVA settings are stored in yaml in:

  • /etc/lava-server/settings.conf
  • /etc/lava-server/settings.yaml
  • /etc/lava-server/settings.d/*.yaml

LAVA will load the files in this exact order. Files in the settings.d directory will be alphabetically ordered.

Merging files

If a variable is defined in two files, the value from the last file will override the value from the first one.

In a fresh installation, LAVA installer will automatically create some setting files for you:

  • /etc/lava-server/settings.d/00-secret-key.yaml: django SECRET_KEY
  • /etc/lava-server/settings.d/00-database.yaml: django DATABASES

You can then create some file to customize your instance. The list of available values is listed in:

Legacy configuration

In previous LAVA versions, the settings where saved in three files:

  • /etc/lava-server/settings.conf (json)
  • /etc/lava-server/secret_key.conf (json)
  • /etc/lava-server/instance.conf (ini)

LAVA will still load this files prior to load the new setting files.

Applying changes

When updating the settings, you should restart every LAVA services.

Worker configuration

Devices

The device dictionaries are stored into /etc/lava-server/dispatcher-config/devices/. The files should belong to lavaserver user and group.

More information in the technical reference.

Device-types

The device-type templates are stored into /etc/lava-server/dispatcher-config/device-types/ The files should belong to lavaserver user and group.

For supported device-types, the templates provided by LAVA are stored in /usr/share/lava-server/device-types. LAVA looks for the template first in /etc/lava-server/dispatcher-config/device-types/ and then fallback to /usr/share/lava-server/device-types.

More information in the technical reference.

Health-checks

The health-checks are stored into /etc/lava-server/dispatcher-config/health-checks/ The files should belong to lavaserver user and group.

More information in the technical reference.

Dispatcher

TODO