Skip to Content

Custom .Net Configuration

Vinyl 3.1+

For Vinyl versions 3.1 and later, these settings get configured via an appsettings.json file that resides in the main Vinyl directory. Please note there are samples for different appsettings in the samples folder.

Vinyl 3.0 and Earlier

Vinyl is a .Net application. As such, many settings are configured using the Web.config file. The Web.config file is overwritten on upgrade. Because the Web.config file may change with each new release, administrators cannot simply restore a Web.config file from a previous version of Vinyl over top of the current Web.config file. For this reason, administrators should avoid making changes to the Web.config file.

Vinyl provides limited support for modifying .Net configuration. Vinyl will load the appSettings element from an external file. Specifically, Vinly will load the appSettings element from the following file:

{Vinyl}\Config\AppSettings.config

Although the AppSettings.config file gets overwritten on an upgrade, it is always empty. It is therefore safe for administrators to restore a copy of the AppSettings.config file from the previous version of Vinyl over top of the current AppSettings.config file.

Note

Values in the AppSettings.config file override those defined in the Web.config file.