vieter/docs/content/configuration.md

3.0 KiB

weight
20

Configuration

All vieter operations by default try to read in the TOML file ~/.vieterrc for configuration. The location of this file can be changed by using the -f flag.

If the above file doesn't exist or you wish to override some of its settings, configuration is also possible using environment variables. Every variable in the config file has a respective environment variable of the following form: say the variable is called api_key, then the respective environment variable would be VIETER_API_KEY. In essence, it's the variable in uppercase prepended with VIETER_.

If a variable is both present in the config file & as an environment variable, the value in the environment variable is used.

{{< hint info >}} Note
All environment variables can also be provided from a file by appending them with _FILE. This for example allows you to provide the API key from a docker secrets file. {{< /hint >}}

Modes

The vieter binary can run in several "modes", indicated by the first argument passed to them. Each mode requires a different configuration.

Server

  • log_level: defines how much logs to show. Valid values are one of FATAL, ERROR, WARN, INFO or DEBUG. Defaults to WARN
  • log_file: log file to write logs to. Defaults to vieter.log in the current directory.
  • pkg_dir: where Vieter should store the actual package archives.
  • data_dir: where Vieter stores the repositories, log file & database.
  • api_key: the API key to use when authenticating requests.
  • default_arch: architecture to always add packages of arch any to.

Builder

  • api_key: the API key to use when authenticating requests.
  • address: Base your URL of your Vieter instance, e.g. https://example.com
  • base_image: image to use when building a package. It should be an Archlinux image. The default if not configured is archlinux:base-devel, but this image only supports arm64. If you require aarch64 support as well, consider using menci/archlinuxarm:base-devel (GH)

Repos

  • api_key: the API key to use when authenticating requests.
  • address: Base your URL of your Vieter instance, e.g. https://example.com

Cron

  • log_level: defines how much logs to show. Valid values are one of FATAL, ERROR, WARN, INFO or DEBUG. Defaults to WARN
  • api_key: the API key to use when authenticating requests.
  • address: Base your URL of your Vieter instance, e.g. https://example.com. This must be the publicly facing URL of your Vieter instance.
  • data_dir: where Vieter stores the log file.
  • base_image: Docker image from which to create the builder images.
  • max_concurrent_builds: amount of builds to run at once.
  • api_update_frequency: how frequenty to check for changes in the repo list.
  • image_rebuild+frequency: how frequently to rebuild the builder image
  • global_schedule: cron schedule to use for any repo without an individual schedule