How to specify the port an ASP NET Core application is hosted on

Question

When using WebHostBuilder in a Main entry-point  how can I specify the port it binds to   By default it uses 5000   Note that this question is specific to the new ASP NET Core API  currently in 1 0 0-RC2

User · Accepted Answer

In ASP NET Core 3 1  there are 4 main ways to specify a custom port    Using command line arguments  by starting your  NET application with --urls  url     dotnet run --urls http   localhost 5001     Using appsettings json  by adding a Urls node         Urls    http   localhost 5001       Using environment variables  with ASPNETCORE URLS http   localhost 5001   Using UseUrls    if you prefer doing it programmatically    public static class Program       public static void Main string   args    gt          CreateHostBuilder args  Build   Run         public static IHostBuilder CreateHostBuilder string   args    gt          Host CreateDefaultBuilder args               ConfigureWebHostDefaults builder   gt                                builder UseStartup lt Startup gt                     builder UseUrls  http   localhost 5001                         Or  if you re still using the web host builder instead of the generic host builder   public class Program       public static void Main string   args    gt          new WebHostBuilder                UseKestrel                UseContentRoot Directory GetCurrentDirectory                 UseIISIntegration                UseStartup lt Startup gt                 UseUrls  http   localhost 5001                 Build                Run

User · Answer

Above  net core 2 2 the method Main support args with WebHost CreateDefaultBuilder args    public class Program       public static void Main string   args                CreateWebHostBuilder args  Build   Run               public static IWebHostBuilder CreateWebHostBuilder string   args    gt          WebHost CreateDefaultBuilder args               UseStartup lt Startup gt         You can build your project and go to bin run command like this  dotnet  lt yours gt  dll --urls http   localhost 5001   or with multi-urls  dotnet  lt yours gt  dll --urls  http   localhost 5001 https   localhost 5002

User · Answer

I fixed the port issue in Net core 3 1 by using the following  In the Program cs  public class Program       public static void Main string   args                CreateHostBuilder args  Build   Run               public static IHostBuilder CreateHostBuilder string   args    gt  Host CreateDefaultBuilder args           ConfigureWebHost x   gt  x UseUrls  https   localhost 4000    http   localhost 4001             ConfigureWebHostDefaults webBuilder   gt    webBuilder UseStartup lt Startup gt             You can access the application using   http   localhost 4000  https   localhost 4001

User · Answer

You can specify hosting URL without any changes to your app   Create a Properties launchSettings json file in your project directory and fill it with something like this        profiles          MyApp1-Dev              commandName    Project            environmentVariables                  ASPNETCORE ENVIRONMENT    Development                      applicationUrl    http   localhost 5001                 dotnet run command should pick your launchSettings json file and will display it in the console   C  ProjectPath  master       dotnet run Using launch settings from C  ProjectPath Properties launchSettings json    Hosting environment  Development Content root path  C  ProjectPath Now listening on  http   localhost 5001 Application started  Press Ctrl C to shut down     More details  https   docs microsoft com en-us aspnet core fundamentals environments

User · Answer

Alternative solution is to use a hosting json in the root of the project         urls    http   localhost 60000      And then in Program cs  public static void Main string   args        var config   new ConfigurationBuilder            SetBasePath Directory GetCurrentDirectory             AddJsonFile  hosting json   true           Build         var host   new WebHostBuilder            UseKestrel options   gt  options AddServerHeader   false           UseConfiguration config           UseContentRoot Directory GetCurrentDirectory             UseIISIntegration            UseStartup lt Startup gt             Build         host Run

User · Answer

You can insert Kestrel section in asp net core 2 1  appsettings json file      Kestrel          EndPoints            Http              Url    http   0 0 0 0 5002

User · Answer

If using dotnet run  dotnet run --urls  http   localhost 5001

User · Answer

When hosted in docker containers  linux version for me   you might get a  Connection Refused  message  In that case you can use IP address 0 0 0 0 which means  all IP addresses on this machine  instead of the localhost loopback to fix the port forwarding    public class Program       public static void Main string   args                var host   new WebHostBuilder                UseKestrel                UseContentRoot Directory GetCurrentDirectory                 UseIISIntegration                UseStartup lt Startup gt                 UseUrls  http   0 0 0 0 5000                 Build             host Run

User · Answer

Go to properties launchSettings json and find your appname and under this  find applicationUrl  you will see  it is running localhost 5000  change it to whatever you want  and then run dotnet run       hurrah

User · Answer

Alternatively  you can specify port by running app via command line   Simply run command   dotnet run --server urls http   localhost 5001   Note  Where 5001 is the port you want to run on

User · Answer

On  Net Core 3 1 just follow Microsoft Doc that it is pretty simple  kestrel-aspnetcore-3 1  To summarize    Add the below ConfigureServices section to CreateDefaultBuilder on Program cs      using Microsoft Extensions DependencyInjection   public static IHostBuilder CreateHostBuilder string   args    gt      Host CreateDefaultBuilder args           ConfigureServices  context  services    gt                        services Configure lt KestrelServerOptions gt                   context Configuration GetSection  Kestrel                         ConfigureWebHostDefaults webBuilder   gt                        webBuilder UseStartup lt Startup gt                  Add the below basic config to appsettings json file  more config options on Microsoft article     Kestrel          EndPoints              Http                  Url    http   0 0 0 0 5002                     Open CMD or Console on your project Publish Debug Release binaries folder and run   dotnet YourProject dll  Enjoy exploring your site api at your http   localhost 5002

User · Answer

Follow up answer to help anyone doing this with the VS docker integration  I needed to change to port 8080 to run using the  flexible  environment in google appengine   You ll need the following in your Dockerfile   ENV ASPNETCORE URLS http     8080 EXPOSE 8080   and you ll need to modify the port in docker-compose yml as well       ports        -  8080

[.net] How to specify the port an ASP.NET Core application is hosted on?

Examples related to .net

Examples related to asp.net-core