Automatically set appsettings.json for dev and release environments in asp.net core?

I've defined some values in my appsettings.json for things like database connection strings, webapi locations and the like which are different for development, staging and live environments.

Is there a way to have multiple appsettings.json files (like appsettings.live.json, etc, etc) and have the asp.net app just 'know' which one to use based on the build configuration it's running?

Update for .NET Core 3.0+

1. You can use CreateDefaultBuilder which will automatically build and pass a configuration object to your startup class:

   WebHost.CreateDefaultBuilder(args).UseStartup<Startup>();
   

   public class Startup
   {
       public Startup(IConfiguration configuration) // automatically injected
       {
           Configuration = configuration;
       }
       public IConfiguration Configuration { get; }
       /* ... */
   }
   

2. CreateDefaultBuilder automatically includes the appropriate <code>appsettings.<i>Environment</i>.json</code> file so add a separate appsettings file for each environment:

   

3. Then set the ASPNETCORE_ENVIRONMENT environment variable when running / debugging

How to set Environment Variables

Depending on your IDE, there are a couple places dotnet projects traditionally look for environment variables:

• For Visual Studio go to Project > Properties > Debug > Environment Variables:

  

• For Visual Studio Code, edit .vscode/launch.json > env:

  

• Using Launch Settings, edit Properties/launchSettings.json > environmentVariables:

  

  Which can also be selected from the Toolbar in Visual Studio

  

• Using dotnet CLI, use the appropriate syntax for setting environment variables per your OS

  Note: When an app is launched with dotnet run, launchSettings.json is read if available, and environmentVariables settings in launchSettings.json override environment variables.

How does Host.CreateDefaultBuilder work?

.NET Core 3.0 added Host.CreateDefaultBuilder under platform extensions which will provide a default initialization of IConfiguration which provides default configuration for the app in the following order:

1. appsettings.json using the JSON configuration provider.
2. <code>appsettings.<i>Environment</i>.json</code> using the JSON configuration provider. For example:

• <code>appsettings.<i>Production</i>.json</code> or
• <code>appsettings.<i>Development</i>.json</code>

4. App secrets when the app runs in the Development environment.
5. Environment variables using the Environment Variables configuration provider.
6. Command-line arguments using the Command-line configuration provider.

Further Reading - MS Docs

• App startup in ASP.NET Core

• Configuration in ASP.NET Core

• Use multiple environments in ASP.NET Core