This page is likely outdated (last edited on 26 Oct 2007). Visit the new documentation for updated content.


Mono uses configuration files in a few places, the following sections describe what you can use and where.

Configuration files can appear in two places, as a way of configuring assemblies or when using ASP.NET applications.

To configure assemblies, you create a file with the extension .config containing the configuration elements that you want for your assembly. For example, if you want to configure the program “hello.exe” you would create a “hello.exe.config” file. This is not limited to executables, you can also configure libraries, for example “library.dll” and “library.dll.config”.

With ASP.NET applications since there are no assemblies per-se to configure, the configuration lives on the file “web.config” or “Web.config”. These configuration files work on a per-directory basis, so you can have different configuration parameters for different parts of your web application.

The configuration file is an XML file whose root element is <configuration>.



For more information, see:

The documentation on this site is not complete, but it documents some Mono-specific configuration options, the following elements can be nested inside the <configuration> section:


Use the <compilation> setting inside the <configuration> section to control whether debug information must be generated when invoking the compiler.

For example, you could put this in your web.config file for your ASP.NET pages to get debugging symbols for compiler generated code:

      <compilation debug="true" />