All configuration is done with the in yaml files. For clarity we recommend to have one yaml file for each app, named the same as the csharp file but you can configure as many apps and types in one to many yaml files if that is prefered.

Allways use nullable types!

Application instance configuration

Example below instance an application with id light_manager_kitchen and sets a configuration named the_light to a string used by the LightManager class.


class: LightManager
the_light: light.kitchenlightwindow

Inside the app the the_light setting is automatically provitioned to the TheLightproperty if provided in the class. NetDaemon converts python style (used in Home Assistant) to c# style property names. You could use the name the_light for the property too.

public class LightManager : NetDaemonRxApp
#region -- Config properties --
// This property will be automapped with ´the_light´ config
public string? TheLight { get; set; }
/// <summary>
/// Initialize, is automatically run by the daemon
/// </summary>
public override void Initialize()

Advanced configurations options

Yaml type.NET type
a_string: hello world
an_int: 10
a_bool: true

string? AString {get;set;}
int? AnInt {get;set;}
bool? ABool {get;set;}
- Hello
- World
IEnumerable<string>? SimpleList {get;set;}
sequences are always IEnumerable<type>, lists are not supported!
Sequence complexSe code example

Example of complex data types support

This example shows an example of how to use complex configuration options.

class: AppComplexContif
a_string: hello world
an_int: 10
a_bool: true
- this
- is
- cool!
- name: tv
- name: command1
data: some code
- name: command2
data: some code2";
public class AppComplexConfig : NetDaemonApp
public string? AString { get; set; }
public int? AnInt { get; set; }
public bool? ABool { get; set; }
public IEnumerable<string>? AStringList { get; set; }
public IEnumerable<Device>? Devices { get; set; }
public override Task InitializeAsync()
// Do nothing
return Task.CompletedTask;
public class Device
public string? name { get; set; }
public IEnumerable<Command>? commands { get; set; }
public class Command
public string? name { get; set; }
public string? data { get; set; }


Secrets lets you store special variables that are global in the tree scope of the app. secrets.yaml can be excluded in .gitignore to makse sure sensitive data is not pushed to the git repo.

This is how to use secrets. Make any file called secrets.yaml. The application will use the configuration in the first secret file it finds in the path.


mysecret_token: this is a secret!


class: APIManager
token: !secret mysecret_token