Skip to main content

The viktor.config.toml file

New in v13.2.0

The viktor.config.toml file is used to set configuration settings for your app, and is placed on the top level of the application folder:

my-folder
├── app.py
├── requirements.txt
└── viktor.config.toml

The viktor.config.toml file is written in TOML language, which is very similar to basic Python syntax.

app_type​

Changed in v13.3.0

The entry app_type has become obligatory.

The app_type entry in the viktor.config.toml file defines the type of app. App layout, requirements and corresponding feedback errors might differ depending on the chosen app type. Currently, the following types are available:

  • simple: allows for 1 (and only 1) entity type, of which the user can make unlimited entities.
  • tree: no restriction on the number of entity types. An entity type hierarchy can be created by defining children on the parent entity type Controller.
app_type = 'simple'  # 'simple' | 'tree'

enable_privileged_api​

With the enable_privileged_api key, the application code is able to bypass user access restrictions:

enable_privileged_api = true  # true | false

python_version​

note

This Python version does not affect the Python version that is used for development with venv as isolation mode, which is specified using the configure command instead!

Specify the Python version to publish the application with:

python_version = '3.9'  # '3.7' | '3.8' | '3.9' | '3.10'

welcome_text​

note

Supported for app_type = 'tree' only

A welcome text can be customized, which will be shown to the user upon entering the application dashboard. The value is a path pointing to a file located relative to viktor.config.toml. The file supports formatting with Markdown:

welcome_text = "welcome.md"

With welcome.md:

## Welcome to your very first [VIKTOR](https://www.viktor.ai/) application!

Get started engineering the **awesome** today

While automating the *boring*!